Clean Markdown Live Preview

Obsidian-style live preview for markdown files in VS Code: edit markdown with inline rendering, keep raw syntax when a line is active, and get a clean reading experience when inactive.

Why This Extension

• Write and review in one surface: no constant split-view context switching.
• Keep markdown source transparent: active line shows raw syntax.
• Improve readability: heading hierarchy, blockquotes, checkboxes, links, tables, frontmatter, and horizontal rules are rendered inline.

Install

From VS Code Marketplace (recommended)

Option 1 — Quick Open:

1. Press Ctrl+P (Windows/Linux) or ⌘P (macOS) to open Quick Open
2. Type ext install CleanSoftwareOne.md-live-preview
3. Click Install, then Enable

Option 2 — Extensions panel:

1. Press Ctrl+Shift+X (Windows/Linux) or ⇧⌘X (macOS) to open Extensions
2. Search for Clean Markdown Live Preview
3. Click Install, then Enable

Option 3 — Command line:

code --install-extension CleanSoftwareOne.md-live-preview

From a downloaded VSIX file

If you have downloaded the .vsix file directly:

Option 1 — Extensions panel:

1. Press Ctrl+Shift+X (Windows/Linux) or ⇧⌘X (macOS) to open Extensions
2. Click the ... menu (top-right of the panel)
3. Select Install from VSIX...
4. Choose the downloaded .vsix file

Option 2 — Command line:

code --install-extension path/to/md-live-preview-0.0.2.vsix

Then run Developer: Reload Window (Ctrl+Shift+P / ⇧⌘P → "Reload Window").

Quick Start

1. Open a .md file.
2. Run Clean Markdown Live Preview: Open in Live Preview from Command Palette.
3. Use the title-bar toggle button to switch modes.

Usage

Open In Live Preview

Use either:

• Explorer context menu: Open in Live Preview
• Command Palette: Clean Markdown Live Preview: Open in Live Preview

Toggle Live / Source Mode

Use the title-bar toggle button or Command Palette:

• Clean Markdown Live Preview: Toggle Live Preview / Source Mode

Edit While Rendered

• Inactive lines render markdown syntax into readable content.
• Active line reveals raw markdown for precise editing.
• Task checkboxes can be toggled directly in live mode.

Supported Elements

• Headings (H1-H6)
• Bold / italic / strikethrough
• Markdown links and wiki links
• Bullet lists and interactive task checkboxes
• Fenced code blocks and inline code
• Tables (rendered widget)
• Frontmatter properties panel
• Horizontal rules
• Blockquotes

Commands

• Clean Markdown Live Preview: Toggle Live Preview / Source Mode
• Clean Markdown Live Preview: Open in Live Preview

Troubleshooting

• If UI changes do not appear: run Developer: Reload Window.
• If packaging changes are missing: rebuild with pnpm build and repackage with pnpm package.

For contributor setup and release automation details, see CONTRIBUTING.md.

License

MIT