Markdown Buddy 2026: A Native macOS Deep Dive

Most Markdown coverage in 2026 has drifted toward headless frameworks, browser-based editors, or large IDE suites. Markdown Buddy goes the other way: it is a single-purpose native macOS app from a solo developer, Show HN launched on August 20, 2026, and it makes a deliberate trade. It does not try to be a vault, a plugin host, or a backlink database. It tries to be the best possible native viewer and editor for the .md files you already have on disk.

Why a native macOS Markdown editor in 2026

The Show HN post by JanParis identified two specific gaps that most cross-platform editors leave open on macOS: Finder Quick Look renders .md files as raw text, and Xcode shows a README as plain source. Both are daily annoyances for anyone whose documentation lives in Markdown next to the code it describes. Markdown Buddy ships two macOS extensions that close both gaps, and the same renderer powers all three surfaces.

The app itself is 4.8 MB, sandboxed, built in Swift and AppKit. The editor pane is a plain NSTextView. The rendered preview uses WKWebView, so the system engine handles Markdown rather than a bundled browser engine. That choice is the source of the size difference between Markdown Buddy and competing Electron-based editors.

What Markdown Buddy 2.2.5 actually does

The current Mac App Store release is version 2.2.5. The feature set splits into three groups:

• Workspace tools: open a folder as a workspace, browse every .md in a tree sidebar, run cross-folder search with regex, open tabs with session restore on launch.
• Link map: a graph view (Command-Shift-G) of links between every .md file in the workspace, with broken links flagged and listed. Click a node to open the document.
• Inline editing: clickable task lists that update the file when you tick the box, YAML front matter shown as a collapsible panel, tag filter in the sidebar, link autocompletion when you type the closing parenthesis of a link.
• Preview modes: Rendered, Source, or Side-by-side via Command-Shift-R. Synced scrolling, syntax-colored Markdown as you type, optional auto-save.
• Counters: a status bar under the editor counts characters, characters without spaces, words, and lines. Word splitting follows the language, so Japanese and Chinese count properly.
• Finder and Xcode: Quick Look extension renders any .md on Space-bar; thumbnails in Icons, Columns, and Gallery views. Xcode Source Editor extension opens the current file rendered, from the Editor menu.

Eight interface languages ship out of the box: English, French, German, Spanish, Italian, Japanese, Simplified Chinese, and Korean. Menus, settings, and every screen follow the wording of each market.

The Asian-language input detail that mattered

One implementation choice deserves its own paragraph because it is the kind of bug that quietly ruins tools for a large part of the world. The live preview restyles NSTextStorage as you type. The hard rule is that it must never touch attributes while an input method is composing, or Japanese, Chinese, and Korean input methods break, and so do dead keys for accented Latin. The author calls this out as a single hasMarkedText() guard in three places, but notes that without it the app is unusable for a large part of the world and that several competing editors carry review complaints about exactly this regression.

Pricing, distribution, and the honest "I sold two copies" line

The current Mac App Store price is EUR 5.99 as a one-time purchase, with no subscription, no in-app purchases, and nothing collected. The original Show HN launch in August 2026 listed EUR 0.99 for the v1 release; the move to EUR 5.99 happened once the workspace tree, link map, and the eight-language UI shipped. The distribution story is unusually candid: the author reported the product page gets about a hundred views annually and asked the Show HN thread for feedback on distribution rather than the code itself.

There is one operational caveat worth flagging for any team considering Markdown Buddy: it is Mac App Store only, so there is no trial. macOS 14 or later is required. Promo codes are occasionally handed out via the Show HN thread in exchange for feedback.

How Markdown Buddy compares to the rest of the 2026 Markdown landscape

Markdown Buddy is one slice of a much wider 2026 Markdown tool landscape. The short version of where each slice sits:

• Native single-purpose editors: Markdown Buddy. Focused on viewing and editing .md files on macOS with Quick Look and Xcode integration. No vault, no plugins, no backlink database.
• Vault-based knowledge tools: Obsidian, Logseq. Treat every .md file as part of a vault with community plugins, backlinks, and graph views across the file system.
• WYSIWYG single-window editors: Typora, iA Writer. A single window with rendered output as you type, optimized for distraction-free writing.
• Headless frameworks: CodeMirror 6, Milkdown, BlockNote, Tiptap, Lexical, Plate. Programmable editor cores that developers embed in their own apps.
• Browser-side converters: md2rich, Skilldocs. Not editors in the strict sense: they take Markdown as input and produce rich text for LinkedIn, X Articles, Medium, and Notion.
• Cloud collaboration: Skilldocs, Notion's Markdown import, HackMD. Multi-user editing of the same Markdown source.
• Capture tools: tweet.md, ThreadGrab, Markleft. Convert external content (X threads, web pages) into clean Markdown for editing.

Markdown Buddy does not overlap with the headless frameworks or the vault-based tools. The closest match for a "what is this like" comparison is a fast, native file viewer with editor capabilities. If you have ever wanted Quick Look to render .md properly across an entire project folder, this is the closest thing to it in 2026.

Where Markdown Buddy fits in a publishing workflow

The cleanest place for Markdown Buddy in a writer's stack is as the local editing surface. Open the project folder, browse the .md tree, fix broken links flagged by the link map, run cross-folder search to find every reference to a renamed API. When the draft is ready, copy the canonical Markdown source out of the editor and convert it into copy-ready rich text for the platform you are publishing to.

That conversion step is where md2rich enters. md2rich is a browser-side converter: paste Markdown, copy rich text. The conversion runs in the browser using the same HTML the WKWebView preview uses, which means the rendering you saw in the editor matches what gets pasted into LinkedIn, X Articles, Medium, or Notion. Nothing is uploaded, so the draft does not leave your machine.

A typical loop looks like this:

1. Open the project workspace in Markdown Buddy.
2. Edit the README or documentation file in the Side-by-side preview so you see the rendered output as you type.
3. Run cross-folder search to verify every internal link still resolves.
4. Copy the Markdown source.
5. Paste the source into md2rich and copy the rendered rich text.
6. Paste into LinkedIn, X Articles, Medium, or Notion.

The honest verdict

Markdown Buddy is not the right tool if you want a vault, a plugin ecosystem, or backlinks. Obsidian and Logseq already cover that ground well. Markdown Buddy is the right tool if you want a fast native macOS surface for editing the .md files you already have, with Quick Look and Xcode integration that no cross-platform editor bothers to ship. At EUR 5.99 with no subscription and no telemetry, the price-to-utility ratio for a developer or technical writer who lives in READMEs is hard to beat.

The bigger story for 2026 is that the Markdown tool landscape has fragmented into well-defined slices: native single-purpose editors, vault tools, headless frameworks, browser-side converters, cloud collaboration, and capture tools. Each slice does one thing well. The writer's job is to pick the slice that matches the job and not chase a single tool that tries to do everything.

FAQ

What is Markdown Buddy?

Markdown Buddy is a native macOS Markdown editor written in Swift and AppKit. Version 2.2.5 ships at 4.8 MB sandboxed, runs as a standalone app, a Finder Quick Look extension, and an Xcode Source Editor extension. The editor pane is NSTextView; the rendered preview uses WKWebView so the system engine handles Markdown rather than a bundled browser.

How much does Markdown Buddy cost?

The current Mac App Store price is EUR 5.99 as a one-time purchase with no subscription and no in-app purchases. The original Show HN launch in August 2026 listed EUR 0.99 for the v1 release; v2.x moved to EUR 5.99 once the workspace tree, link map, and eight-language UI shipped. Nothing is collected, no telemetry, no account.

What macOS version does Markdown Buddy require?

Markdown Buddy requires macOS 14 Sonoma or later. It is Mac App Store only, so there is no direct download or trial. The author occasionally hands out promo codes via the Show HN thread for feedback in exchange.

How is Markdown Buddy different from Obsidian or Typora?

Markdown Buddy is not a vault, not a plugin host, and does not maintain a backlink database. Obsidian treats every .md file as part of a vault you can extend with community plugins; Typora is a single-window WYSIWYG editor. Markdown Buddy is closer to a focused native file viewer and editor with Quick Look and Xcode integration, intended for project README files, technical documentation, and developer-facing writing.

Does Markdown Buddy handle Asian language input correctly?

Yes. The live preview restyles NSTextStorage as you type, but the restyle is gated by a hasMarkedText() guard so it never touches attributes while an input method is composing. This matters for Japanese, Chinese, and Korean input methods and for dead keys on accented Latin characters.

How does Markdown Buddy fit into a Markdown publishing workflow?

Write the canonical draft in Markdown Buddy using the workspace tree and link map to keep internal references consistent. When the draft is ready for distribution, copy the Markdown source and run it through md2rich to produce copy-ready rich text for LinkedIn, X Articles, Medium, and Notion. The conversion happens client-side, so the draft never has to be uploaded.

Conclusion: native editor, browser-side converter

Markdown Buddy is the right answer to a narrow, real question: how do I view and edit the .md files I already have on macOS without firing up a vault or an Electron app? It does not try to be a publishing platform, and that is its strength. Pair it with a browser-side converter for distribution and you have a stack that respects the local-first ethos of plain text while still producing rich text where it matters.

Try md2rich. Paste Markdown, copy rich text. Client-side, no upload, works in the browser.

Filed under: md2rich Blog. Written by the md2rich team (about.me/jasonxmai).