KiteExplainer
Markdown Reader vs Editor on Mac: what's the difference?
The distinction matters more than you'd think — and most apps are better at one than the other.
Markdown reader
Renders a .md file as a formatted document. Shows headings as headings, bold as bold, code blocks as code blocks. You see the output, not the syntax. Quick Look is the ideal reader — no app to open.
Examples: Kite (Quick Look), Marked 2, PDF viewers
Markdown editor
Lets you create and modify .md files. May show raw syntax (split-pane editors) or formatted output (WYSIWYG editors). Focus is on writing and editing, not just reading.
Examples: VS Code, MacDown, Typora, iA Writer
Why most apps are better at one than the other
Editors are optimized for cursor behavior, typing performance, and syntax handling. Readers are optimized for layout, typography, and rendering fidelity. The UI decisions that make a great editor often conflict with those that make a great reader.
VS Code is a great editor, a mediocre reader — the preview pane is functional but not pleasant for reading long docs. Marked 2 is an excellent reader but has no editing capability. Most tools fall somewhere on that spectrum rather than nailing both.
The rise of AI coding tools has sharpened this distinction. Claude Code and Cursor generate .md files that you need to read — not necessarily edit. For that use case, reader quality matters more than editor quality.
Which do you need?
I mostly read .md files generated by AI tools
You need a reader. Kite's Quick Look extension is the fastest path — press spacebar in Finder and read. No editor to open.
→ Kite
I write long-form docs and articles in Markdown
You need an editor. WYSIWYG editors (Kite, Typora, iA Writer) are most comfortable for extended writing sessions. Split-pane works if you prefer seeing the syntax.
→ Kite or Typora
I edit code and documentation in the same app
You need a code editor with Markdown support. VS Code or Cursor with the built-in preview works well. Not a dedicated Markdown reader, but convenient when you're already there.
→ VS Code
I need both — read AI output and occasionally edit
You need an app that does both well. Kite is designed for exactly this: Quick Look for reading, WYSIWYG editor for editing, without needing two apps.
→ Kite
Kite: built to do both
Quick Look extension for reading (spacebar in Finder, no app to open) plus a WYSIWYG editor for editing. Native macOS, $14.99 once.
Download Kite — $14.99 one-time