Skip to content

Improve markdown preview styles - #58465

Merged
danilo-leal merged 2 commits into
mainfrom
markdown-preview-styles
Jun 3, 2026
Merged

Improve markdown preview styles#58465
danilo-leal merged 2 commits into
mainfrom
markdown-preview-styles

Conversation

@danilo-leal

Copy link
Copy Markdown
Member

Closes #58364

This PR adjusts heading and body text font size (mostly reducing them a bit), as well as colors (making the body text slightly darker than headings), and content separation, through adding a bottom border to headings until H3.

Before After
Screenshot 2026-06-03 at 5  01@2x Screenshot 2026-06-03 at 5  02@2x

Release Notes:

  • Improved markdown preview styles, making it more legible and easier to parse.

@cla-bot cla-bot Bot added the cla-signed The user has signed the Contributor License Agreement label Jun 3, 2026
@zed-community-bot zed-community-bot Bot added the staff Pull requests authored by a current member of Zed staff label Jun 3, 2026
@danilo-leal
danilo-leal added this pull request to the merge queue Jun 3, 2026
Merged via the queue into main with commit ddb4f98 Jun 3, 2026
32 checks passed
@danilo-leal
danilo-leal deleted the markdown-preview-styles branch June 3, 2026 20:42
TomPlanche pushed a commit to TomPlanche/zed that referenced this pull request Jun 8, 2026
Closes zed-industries#58364

This PR adjusts heading and body text font size (mostly reducing them a
bit), as well as colors (making the body text slightly darker than
headings), and content separation, through adding a bottom border to
headings until H3.

| Before | After |
|--------|--------|
| <img width="2620" height="2044" alt="Screenshot 2026-06-03 at 5 
01@2x"
src="https://github.com/user-attachments/assets/d10c7916-e4cb-4999-8be1-08e26793fd35"
/> | <img width="2622" height="2044" alt="Screenshot 2026-06-03 at 5 
02@2x"
src="https://github.com/user-attachments/assets/13105982-283d-436b-973e-b6198cd2503b"
/> |

Release Notes:

- Improved markdown preview styles, making it more legible and easier to
parse.
@fuzenco

fuzenco commented Jun 11, 2026

Copy link
Copy Markdown

Thanks team. Preview 1.7.1 is much better! But please consider adding more spacing between paragraphs; after block-level items like ULs need more spacing too. The vertical rhythm is too tight.

DavidBK pushed a commit to DavidBK/zedd that referenced this pull request Jun 14, 2026
Follow up to zed-industries#58465 adding
more breathing room between headings _and_ making inline code links use
the `accent` text color.

Release Notes:

- N/A
pull Bot pushed a commit to relaxcn/zed that referenced this pull request Jun 14, 2026
Follow up to zed-industries#58465 adding
more breathing room between headings _and_ making inline code links use
the `accent` text color.

Release Notes:

- N/A
zed-zippy Bot added a commit that referenced this pull request Jun 16, 2026
…eview) (#59438)

Cherry-pick of #59291 to preview

----
Follow up to #58465 adding
more breathing room between headings _and_ making inline code links use
the `accent` text color.

Release Notes:

- N/A

Co-authored-by: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
@nertzy

nertzy commented Jun 17, 2026

Copy link
Copy Markdown

Yes line-height is way too compressed - please look at inspiration from projects like tailwind-typography which aims to have a good default set of styles for prose - including better vertical rhythm across the board.

https://tailwindcss-typography.vercel.app/

This was referenced Jun 18, 2026
@BigRedT

BigRedT commented Jun 18, 2026

Copy link
Copy Markdown

I see this adds a horizontal line (or perhaps a bottom border) after each heading. This is great for level 1 and 2 headings (# and ##), but it becomes too much for H3 and onwards. Please see GitHub's Markdown for example - https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax

@xtrasmal

Copy link
Copy Markdown
Contributor

It really needs a proofreading from an actual designer.

It feels to compact, not balanced, like reading the unformatted markdown.

jonx pushed a commit to jonx/zed-aros that referenced this pull request Jul 17, 2026
Closes zed-industries#58364

This PR adjusts heading and body text font size (mostly reducing them a
bit), as well as colors (making the body text slightly darker than
headings), and content separation, through adding a bottom border to
headings until H3.

| Before | After |
|--------|--------|
| <img width="2620" height="2044" alt="Screenshot 2026-06-03 at 5 
01@2x"
src="https://github.com/user-attachments/assets/d10c7916-e4cb-4999-8be1-08e26793fd35"
/> | <img width="2622" height="2044" alt="Screenshot 2026-06-03 at 5 
02@2x"
src="https://github.com/user-attachments/assets/13105982-283d-436b-973e-b6198cd2503b"
/> |

Release Notes:

- Improved markdown preview styles, making it more legible and easier to
parse.
jolutz pushed a commit to jolutz/zed that referenced this pull request Aug 8, 2026
Closes zed-industries#58364

This PR adjusts heading and body text font size (mostly reducing them a
bit), as well as colors (making the body text slightly darker than
headings), and content separation, through adding a bottom border to
headings until H3.

| Before | After |
|--------|--------|
| <img width="2620" height="2044" alt="Screenshot 2026-06-03 at 5 
01@2x"
src="https://github.com/user-attachments/assets/d10c7916-e4cb-4999-8be1-08e26793fd35"
/> | <img width="2622" height="2044" alt="Screenshot 2026-06-03 at 5 
02@2x"
src="https://github.com/user-attachments/assets/13105982-283d-436b-973e-b6198cd2503b"
/> |

Release Notes:

- Improved markdown preview styles, making it more legible and easier to
parse.
jolutz pushed a commit to jolutz/zed that referenced this pull request Aug 8, 2026
…rry-pick to preview) (zed-industries#59438)

Cherry-pick of zed-industries#59291 to preview

----
Follow up to zed-industries#58465 adding
more breathing room between headings _and_ making inline code links use
the `accent` text color.

Release Notes:

- N/A

Co-authored-by: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
jolutz pushed a commit to jolutz/zed that referenced this pull request Aug 8, 2026
Follow up to zed-industries#58465 adding
more breathing room between headings _and_ making inline code links use
the `accent` text color.

Release Notes:

- N/A
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed The user has signed the Contributor License Agreement staff Pull requests authored by a current member of Zed staff

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Better Markdown preview style.

6 participants