MikeDown EditorA true WYSIWYG Markdown editor for VS Code — edit markdown visually, right in your editor tabs.
New: optional AI writing tools (Experimental, off by default): rewrite, explain, translate, summarize, suggest titles or properties and inline suggestions as you write, using a model on your own machine (LM Studio, Ollama, oMLX), an API key from a cloud provider (billed by the provider, not a ChatGPT or Claude subscription) or GitHub Copilot through your Copilot plan. See AI Writing Help. MikeDown Desktop is now available for Mac, Windows and Linux (preview), the same editor as a standalone app. More MikeDown
Why MikeDown?The split-pane markdown preview workflow gets old fast — source on one side, rendered output on the other, constantly switching between the two. Standalone markdown editors solve the editing experience but pull you out of VS Code, away from Git integration, multi-language file support, and the extensions you already rely on. MikeDown closes that gap. It's an open-source WYSIWYG Markdown editor that lives entirely inside VS Code. Open multiple markdown files across panes, windows, and monitors — all without leaving your editor. Make MikeDown your default Markdown editorBy default, VS Code opens The first time you install MikeDown, it offers to do this for you with a one-click prompt. Missed it, or said "Not now"? Run MikeDown: Make MikeDown the Default Markdown Editor from the Command Palette ( Prefer to do it by hand: right-click any editor tab → Reopen Editor With… → Configure default editor for Either way, the raw markdown source is always one keystroke away with A note from the developerHi there! Thanks for giving MikeDown a try. I built it for myself a few months ago. I'd used the popular Markdown Preview extension for years, and it's good, but I wanted more of a word processor inside VS Code instead of a split pane. Version 1 was half-decent. Since then I've kept adding features and fixing bugs, and it's now my everyday markdown editor. Thanks too to everyone who has sent in feature requests. Problem is, the marketplace is crowded and it's hard to get noticed. Reviews are what get an extension noticed, so if MikeDown has earned a spot in your workflow, please help others find it by leaving me a review or passing it along to a colleague. Found a bug or have an idea? Open an issue. I usually reply quickly. - Mike ScreenshotsThe in-editor sidebar — Properties (from YAML frontmatter), a per-document outline that follows your cursor, Backlinks, and a metadata footer, all in one pinnable pane:
Multiple markdown documents open side by side, each with full WYSIWYG editing:
Markdown editing alongside code — no separate app, no context switching:
FeaturesIn-Editor SidebarClick the layout-pane icon in the corner of any MikeDown tab to reveal a per-document sidebar containing Properties (from YAML frontmatter), Outline (every heading, with the active section following your cursor and scroll position — click any heading to jump there, or fold its subheadings with the chevron; Fold all / Unfold all sit in the Outline header), Backlinks, and a metadata footer with modified time, word count, and reading time. Pin the sidebar open with the pin button in its header (filled blue pill = pinned), flip it left↔right with the arrow next to the pin, and drag the inner edge to resize. Defaults are controlled via True WYSIWYG EditingEdit markdown visually using a TipTap/ProseMirror-based editor. What you see is what you get — headings render as headings, lists render as lists, and you never have to look at raw syntax unless you want to. WYSIWYG editing in light mode -- task lists, headings, and formatted text rendered live:
Source Mode TogglePress Source mode showing raw markdown with the toolbar still accessible:
Clean WYSIWYG ToolbarA condensed toolbar with dropdown menus for formatting, insert, and export actions. Stays out of the way until you need it. Toolbar dropdown for inserting lists, blockquotes, and code blocks:
Customizable ToolbarRearrange the toolbar to suit how you write. Open Settings (the gear), go to the Toolbar tab and choose Customize Toolbar, or right-click the toolbar. Drag buttons into place, or use the keyboard, then add separators and flexible spacers from the tray and click Done to save. Reset to Default in the same tab brings back the standard toolbar. The layout syncs with VS Code Settings Sync. Slash Commands (new in 2.11)Type Math (new in 2.12)Inline Tags (new in 2.12)Inline Smart PastePaste content from Google Docs, Microsoft Word, Slack, web pages, and other rich-text sources. MikeDown converts it to clean markdown automatically. GitHub Flavored MarkdownFull GFM support including tables, task lists, strikethrough, and fenced code blocks. Highlight (new in 2.3)Surround text with Emoji (new in 2.3)Type Callouts / Admonitions (new in 2.1)GitHub-style alert blocks render as styled, icon-prefixed panels. Five kinds are recognized:
Insert one from the toolbar Lists & Blocks dropdown (or right-click → Callout) — the five kinds are exposed as a row of color-coded badges so you don't have to remember the marker syntax. Toggling between kinds is one click, and saving writes the canonical Table of ContentsType AI Writing Help (experimental, off by default)AI is optional and off until you turn on AI features (
PrivacyWith a cloud engine:
Each cloud engine links its provider's own privacy or API data-use page: expand What this means above the cloud engines on the AI Engines page (also shown in setup), open an engine and expand What is sent, or choose Read the provider's policy in the consent prompt, which opens the page in your browser and then asks again. The prompt also says what that request sends: the selection and the paragraph around it for Rewrite, Explain and Translate, the whole document (up to what fits the model) for Summary, Titles and whole-document Translate, the document with its frontmatter and the workspace's tag names for Properties, and for Inline suggestions the text around the cursor (a few paragraphs before it, the headings earlier in the document, and a short stretch after it) each time you pause. Documentation Bases (experimental, off by default)With
Each answer has numbered citations that open the section they came from, and Insert puts the answer at the cursor with links to those sections. Copy and Save export an answer on request; otherwise the chat history is kept in memory and cleared when you close the panel. Each question stands alone: the model does not see earlier answers. MikeDown Desktop has the same panel and bases. Add a base on the Documentation bases page of the Settings modal, or choose Add this workspace folder. Bases are stored in your user settings only (
Link Navigation and Autocomplete
Broken Link DetectionLinks pointing to missing files or nonexistent headings get a red wavy underline, so you catch broken references before your readers do. Backlinks (in-editor in 2.3)The list of files that link to the current document now lives in the in-editor sidebar — open the sidebar with the Properties Panel (new in 2.3)Documents with YAML frontmatter get a Properties section at the top of the sidebar with key:value rows pulled straight from the frontmatter (tags render as inline pills). The section disappears entirely when the document has no frontmatter — no empty state. Document Metadata Footer (new in 2.3)A thin strip at the bottom of the sidebar shows the file's modified time (relative — "5 minutes ago", "yesterday"), live word count, and estimated reading time at 225 WPM. Table EditingInsert tables with a grid picker, edit with a contextual toolbar, drag handles for reordering rows and columns, and multi-cell selection support. Find and ReplaceFull find-and-replace inside the WYSIWYG editor. Most WYSIWYG markdown editors skip this — MikeDown does not. Code Block Syntax Highlighting192 languages supported via lowlight/highlight.js. Code blocks render with proper syntax coloring in the editor. Hover any code block to reveal a Copy button in the top-right corner — one click copies the block's contents to your clipboard. Frontmatter SupportYAML frontmatter blocks display as a collapsible section above the editor content. Edit metadata without switching to source mode. Editor-Only Theme ToggleSwitch between light and dark mode inside MikeDown editor tabs without changing VS Code's global theme. Handy when you want a light writing surface but a dark IDE. Export and Share
Image SupportImages render inline. Click an image to access an edit popover for adjusting source, alt text, and title. Paste a screenshot (Cmd/Ctrl+V) or drag an image file into the editor to save it to a sibling Right-click an image to access Resize 75% / 50% / 25% presets — handy for halving Mac high-DPI screenshots that come in at 2× physical size. By default the resize overwrites the original file in place; flip When you save, MikeDown also cleans up unreferenced images. To keep this safe, three conditions must all hold before a file is deleted: it must live inside the configured Getting StartedInstallInstall MikeDown Editor from the VS Code Marketplace, or search for "MikeDown" in the VS Code Extensions panel and click Install. Open your first file
Make MikeDown the default editor for markdown files in VS CodeBy default, VS Code opens
Now every Open
|
| Action | Mac | Windows / Linux |
|---|---|---|
| Toggle Bold | Cmd+B |
Ctrl+B |
| Toggle Italic | Cmd+I |
Ctrl+I |
| Toggle Strikethrough | Cmd+Shift+S |
Ctrl+Shift+S |
| Toggle Inline Code | Cmd+Shift+K |
Ctrl+Shift+K |
| Toggle Bullet List | Cmd+. |
Ctrl+. |
| Toggle Ordered List | Cmd+3 |
Ctrl+3 |
| Toggle Task List | Cmd+8 |
Ctrl+8 |
| Toggle Sidebar | Cmd+\ |
Ctrl+\ |
| Toggle Source Mode | Cmd+/ |
Ctrl+/ |
| Undo | Cmd+Z |
Ctrl+Z |
| Redo | Cmd+Shift+Z |
Ctrl+Shift+Z |
Settings
MikeDown exposes the following settings under mikedown.* in VS Code's Settings UI:
| Setting | Default | Description |
|---|---|---|
mikedown.defaultEditor |
false |
Open .md files in MikeDown by default |
mikedown.fontFamily |
(system sans-serif) | Font family for the editing area |
mikedown.fontSize |
15 |
Font size in pixels (10--36) |
mikedown.ctrlWheelZoom |
true |
Ctrl+scroll (Cmd on macOS) or trackpad pinch changes the editor font size |
mikedown.linkClickBehavior |
openNewTab |
What Cmd+Click does on links: navigate in current tab, open new tab, or show context menu |
mikedown.themeToggleScope |
editorOnly |
Whether the theme toggle affects only MikeDown or VS Code globally |
mikedown.editorTheme |
auto |
Override theme for MikeDown tabs: auto, light, or dark |
mikedown.autoReloadUnmodifiedFiles |
true |
Auto-reload when external changes are detected |
mikedown.markdownNormalization |
preserve |
Normalize markdown syntax on save, or preserve original style |
mikedown.normalizationStyle.boldMarker |
** |
Bold marker when normalization is enabled |
mikedown.normalizationStyle.italicMarker |
* |
Italic marker when normalization is enabled |
mikedown.normalizationStyle.listMarker |
- |
Unordered list marker when normalization is enabled |
mikedown.normalizationStyle.headingStyle |
atx |
Heading style when normalization is enabled: atx (# Heading) or setext (underline) |
mikedown.imagePaste.enabled |
true |
Save pasted/dropped images automatically. Disable to fall back to VS Code's default paste behavior |
mikedown.imagePaste.folder |
images |
Folder name (or relative path) where pasted images are saved; auto-created. Supports ${docName} for a folder per document (e.g. assets/${docName}) |
mikedown.imagePaste.folderRelativeTo |
document |
Resolve folder relative to the document directory or the workspace root |
mikedown.imagePaste.filenamePattern |
${docName}-${timestamp} |
Pattern with tokens ${docName}, ${date}, ${time}, ${timestamp}, ${hash} (8-char SHA-1, enables dedupe), ${index} |
mikedown.imagePaste.pathStyle |
relative |
Insert path relative to the document, or workspace-absolute (leading /) |
mikedown.imagePaste.altText |
empty |
Alt text source: empty, filename, or prompt (asks on each paste) |
mikedown.imagePaste.maxSizeMB |
10 |
Reject pastes larger than this (1--200) |
mikedown.imagePaste.cleanupUnreferenced |
true |
Delete unreferenced images on save (only inside the configured imagePaste.folder and only when no other markdown file references them) |
mikedown.imageResize.overwrite |
true |
When resizing from the image popover, overwrite the original file. When false, write a sibling like foo-50pct.png and update the markdown link |
mikedown.slashCommands.enabled |
true |
Show the slash command menu when typing / at the start of a line or after whitespace |
mikedown.slashCommands.dateFormat |
iso |
Date format used by the /date and /datetime slash commands: iso or long |
mikedown.slashCommands.timeZone |
local |
Time zone used by the /date and /datetime slash commands: local, UTC, or an IANA zone name |
mikedown.renderMath |
true |
Render \$inline\$ and \$\$display\$\$ LaTeX with KaTeX. When off, formulas show as raw source |
mikedown.headingNumbering |
off |
Show a toolbar button that writes section numbers (1, 1.1, 1.1.1) into heading text and keeps them updated: off, fromH1, or fromH2 (Heading 1 is the title) |
mikedown.tocStyle |
list |
What Insert > Table of Contents adds: list (heading links between <!-- toc --> markers, works on GitHub) or placeholder (a single [toc] line). Both styles are always recognized |
mikedown.tables.padColumns |
false |
Pad every cell of a Markdown table to its column's widest cell (wide characters and emoji count as two columns) so the pipes line up in the source; alignment colons are kept. Off writes each cell as is. Only the file text changes |
mikedown.tags.enabled |
true |
Highlight #tags, offer tag autocomplete, and show the sidebar Tags section |
mikedown.renderMermaidDiagrams |
true |
Render ```mermaid code blocks as diagrams |
mikedown.support.showSidebarLink |
true |
Show a small Support MikeDown link in the in-editor sidebar footer |
Requirements
- VS Code 1.109.0 or later
Known Limitations
- Complex nested markdown structures may not round-trip perfectly in all cases
- Very large files (10,000+ lines) may have slower initial load times
- Some VS Code extensions that modify markdown files may conflict with the custom editor
Contributing
MikeDown is open source under the MIT License. Bug reports, feature requests, and contributions are welcome on GitHub.
Repository layout
The repo is an npm workspace. The editor sources live in packages/core (@mikedown/core); the VS Code extension host is src/. Run npm install at the root, then npm run compile, npm run test:unit and npm run test:edge. Editor styles are in packages/core/src/styles/, and core-only tests are in packages/core/test/.
packages/core:@mikedown/core, the editor.packages/web-component,packages/react,packages/vue,packages/angular: the framework packages, each a thin layer over core.packages/desktop: MikeDown Desktop.website/: the VS Code page and the Developers hub, built with Vite (npm run build:site).












