Jeff Markdown Preview
A tiny, CSS-only VS Code extension for Markdown.
It contributes:
- A restrained dark Markdown preview palette
- Blue structural accents and warm gold secondary accents
- Styling for headings, links, emphasis, blockquotes, inline code, fenced code containers, tables, lists, rules, images, strikethrough, and keyboard keys
iA Writer Duo S, bundled with the extension, as the Markdown preview font
iA Writer Duo S as the default Markdown editor font, and word wrap for Markdown source
There is no executable extension code. The extension only contributes CSS, a bundled
webfont, and configuration defaults.
The font
The preview is a webview, so the typeface ships inside the extension as woff2 and loads
via @font-face. The preview renders correctly on macOS, Windows, and Linux with
nothing installed.
The Markdown editor font is a different story. The editor is not a webview and can only
use fonts the OS has registered, so [markdown].editor.fontFamily falls back to your
normal editor font unless you install iA Writer Duo S system-wide. To get it there too:
- Download iA Writer fonts (SIL OFL 1.1, free)
- Install
iA Writer Duo/Static/iAWriterDuoS-*.ttf
- macOS — open the files in Font Book, or drop them in
~/Library/Fonts
- Windows — select all four, right-click, Install for all users
- Linux — copy to
~/.local/share/fonts, then fc-cache -f
- Reload VS Code
If you skip this, the preview still looks right; only the editor pane differs.
Install
Download the .vsix from
Releases, then:
code --install-extension jeff-markdown-preview-0.2.1.vsix
Then run Developer: Reload Window if the preview is already open.
Notes
- The palette is scoped to
body.vscode-dark. Under a light theme you get the font and
line height, but VS Code's stock preview colors.
- User settings override this extension's
configurationDefaults. If you already set
markdown.preview.fontFamily or [markdown].editor.fontFamily explicitly, yours wins.
- You do not need a global
markdown.styles entry pointing at a local CSS path. Remove it.
License
Extension: MIT — see LICENSE.
Bundled typeface: iA Writer Duo S, © Information Architects Inc., SIL Open Font License
1.1 — see fonts/LICENSE-iA-Writer.md.