Markdown Export Pro
Preview, export, and share your Markdown — with full Mermaid diagram support.
Markdown Export Pro gives you a live side-by-side preview of your .md files, renders Mermaid diagrams (flowcharts, sequence diagrams, ER diagrams, and more), and lets you export everything to self-contained HTML or Word (.docx) with a single click. No external tools required.
Features
Live Preview with Mermaid Diagrams
Open any Markdown file and click the preview icon in the editor title bar (or run Markdown Export Pro: Open Preview from the Command Palette). You get a real-time side panel that updates as you type, with full support for:
- Standard Markdown (headings, lists, tables, links, images, blockquotes)
- Fenced code blocks with syntax highlighting
- Mermaid diagrams — flowcharts, sequence diagrams, ER diagrams, class diagrams, Gantt charts, and more
Export to Self-Contained HTML
Export your Markdown to a single .html file that works completely offline — all styles, syntax highlighting, and rendered diagrams are inlined. Choose a theme at export time:
- Light — clean light background
- Dark — easy on the eyes
- Auto — includes a toggle button so readers can switch between light and dark
The exported HTML file can be opened in any browser and shared with anyone, no special tools needed.
Export to Word (.docx)
Generate a .docx file directly from your Markdown — no Pandoc or LibreOffice required. Mermaid diagrams are embedded as SVG images, and tables, bold, italic, and code blocks are all preserved.
Works Offline
All rendering libraries are bundled with the extension. No CDN calls, no internet connection needed.
Getting Started
Install the extension from the VS Code Marketplace (search for "Markdown Export Pro")
Open any .md file in VS Code
Preview — click the preview icon in the top-right of the editor, or open the Command Palette (Ctrl+Shift+P) and run:
Markdown Export Pro: Open Preview
Export — right-click in the editor and choose one of:
- Markdown Export Pro: Export as HTML
- Markdown Export Pro: Export as Word (.docx)
You can also run these from the Command Palette.
Commands
| Command |
Description |
Markdown Export Pro: Open Preview |
Open a live preview panel for the current Markdown file |
Markdown Export Pro: Export as HTML |
Export the current file to a self-contained HTML file |
Markdown Export Pro: Export as Word (.docx) |
Export the current file to a Word document |
Settings
You can configure the extension in Settings (Ctrl+,) under Markdown Export Pro:
| Setting |
Options |
Default |
Description |
mdExportPro.defaultTheme |
light, dark, auto |
auto |
Default theme suggested when exporting HTML |
mdExportPro.mermaidTheme |
default, forest, dark, neutral |
default |
Theme used for Mermaid diagrams in preview and exports |
Mermaid Diagram Support
To add a diagram, use a fenced code block with the mermaid language tag:
```mermaid
graph TD
A[Start] --> B{Decision}
B -->|Yes| C[Do something]
B -->|No| D[Do something else]
```
Supported diagram types include flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, pie charts, and more. See the Mermaid documentation for the full list.
Requirements
- VS Code 1.85 or later
- For Word export: Microsoft Office 2019+ or LibreOffice (for best SVG rendering in
.docx files)
Known Issues
- Word export requires Office 2019+ for native SVG image support in
.docx files. Older versions of Office may not display Mermaid diagrams correctly.
Feedback & Issues
Found a bug? Have a feature request? We'd love to hear from you:
- Report an issue — Open an issue on GitHub
- Suggest a feature — Use the GitHub Issues page and tag your issue with
enhancement
- Contribute — Pull requests are welcome! See the repo for development setup instructions.
Release Notes
0.3.0
- Rewrote README with feature documentation, usage guide, and issue reporting links
- Cleaned up extension packaging — removed dev-only files from .vsix
0.2.0
- Live preview with Mermaid diagram rendering
- Export to self-contained HTML with light/dark/auto theme support
- Export to Word (.docx) with embedded SVG diagrams
- Syntax highlighting for fenced code blocks
- Configurable Mermaid and export themes
License
MIT