Peekdown: Markdown Viewer
Quick Look, Edit & Annotate
Only for Mac
$4.99
Make Peekdown your default for .md files. Markdown, Mermaid, math, MDX, and Obsidian notes render right, whether you're in the app or Quick Look.
Quick Look, Edit & Annotate
Peekdown is a Markdown viewer and editor for macOS. It renders your files the way GitHub does — tables, code blocks, task lists, footnotes, LaTeX math, and Mermaid diagrams — and because it's native, your files open instantly.
Open a file to read it, or press Space in the Finder to view it fully rendered in Quick Look. Copy a code block or the whole document from either one.
Keep your files in the sidebar. Create a Space, give it a name, color, and icon, then drag in the files and folders you want grouped together — and create new ones without leaving the app. Everything you open collects in a Recents list shared across windows.
Annotate AI Output: select any rendered text and mark it up — strike, comment, highlight, lock, add a document note, or attach block notes to individual sections — then copy your annotations as a structured prompt for any AI assistant. Your doc auto-reloads when the file changes externally, so you're always reviewing the latest version. You can even see what changed in a +/- diff view.
The built-in editor gives you side-by-side editing with live preview, synced scrolling, and syntax highlighting for 100+ languages.
- Sidebar with Spaces: your own named, color-coded groups of files and folders
- Recents list shared across every window
- Renders GitHub-Flavored Markdown, MDX, and Obsidian syntax
- LaTeX math and Mermaid diagrams, rendered offline with no plugins
- Quick Look previews with the same GitHub formatting
- Annotations visible in Quick Look previews
- Annotate and copy as a structured prompt for any AI assistant
- Obsidian vault support: callouts, highlights, wikilinks, tags, embeds
- Side-by-side editor with live preview and scroll sync
- Interactive checkboxes that save on every tick
- Copy any code block or the whole file
- Pin on top to keep docs visible while you code
- Footnotes with superscript links
- Syntax highlighting for 100+ languages with 8 themes
- Light and dark modes that follow your system
- Preview backgrounds: six dark and six light presets, or any color you pick, saved as swatches
- See what an AI tool or another app changed, in a +/- diff
- Auto-reload, window tabs, find & replace, and more
more Started off with limited features but keeps getting better and better with each update. All the editing and annotation stuff is hidden until you need it. Fast becoming a daily app for me. Looks nice and highly recommend to anyone who wants to preview and edit markdown.
Started off with limited features but keeps getting better and better with each update. All the editing and annotation stuff is hidden until you need it. Fast becoming a daily app for me. Looks nice and highly recommend to anyone who wants to preview and edit markdown.
I love how much usage Markdown has gotten in the past couple years, but I kept having a problem where it would be unclear what the best app to open up a Markdown file would be. Should I open it up in my code editor? It has coding syntax, right? But VS Code is too heavy for one file. And the rendered view (while possible to see) would be far out of the way. Or should I open it up in Obsidian, where I keep my notes? But Obsidian is for my vault, not one-off files.Peekdown is finally the app that I can confidently set as the default for all of my Markdown files on macOS—and it has all the qualities you’d expect to come with that. It’s fast to run and open. Its user experience is 99% invisible. It just works.
I love how much usage Markdown has gotten in the past couple years, but I kept having a problem where it would be unclear what the best app to open up a Markdown file would be. Should I open it up in my code editor? It has coding syntax, right? But VS Code is too heavy for one file. And the rendered view (while possible to see) would be far out of the way. Or should I open it up in Obsidian, where I keep my notes? But Obsidian is for my vault, not one-off files.Peekdown is finally the app that I can confidently set as the default for all of my Markdown files on macOS—and it has all the qualities you’d expect to come with that. It’s fast to run and open. Its user experience is 99% invisible. It just works.
Easily worth a dollar. I guess it does more than just show markdown, but that stuff stays out of your way. Looks good, renders right, and even some syntax highlighting. (Though now that you’ve gone that step further, I need it to highlight code based on its language. And that probably means figuring out how to parse the dumb “comment inside the text box” way that LLMs love to do it instead of the GH style.)
Developer Response Thank you very much! Code highlighting is now available in v1.3.
Easily worth a dollar. I guess it does more than just show markdown, but that stuff stays out of your way. Looks good, renders right, and even some syntax highlighting. (Though now that you’ve gone that step further, I need it to highlight code based on its language. And that probably means figuring out how to parse the dumb “comment inside the text box” way that LLMs love to do it instead of the GH style.)
Thank you very much! Code highlighting is now available in v1.3.
What's New in 3.3
- Colors you pick in Settings > Preview are now saved as swatches
- New option to hide the toolbar (Option-Command-T)
- New menu items for New Space, Copy Document and Reset Checkboxes
- Reworded View menu items for better consistency
Fixed
- Window sizes are remembered when exiting full screen
- Opening or closing the sidebar or editor in full screen no longer leaves the window too narrow or too wide afterward
- A new document opened in full screen no longer fills the screen after exiting
3.3 5d ago
What's New in 3.2
- Background presets: pick from six dark and six light preview backgrounds in Settings > Preview
- Custom background: pick any color with the color wheel in Settings > Preview, and the text stays readable on it
- Full-Width Text in the View menu (Option-Z) lets text fill the window instead of a centered column
- The editor has its own theme for Light and Dark mode
- The editor matches the preview's background by default
- Image button in the formatting toolbar
- Annotation toolbar is now a native macOS popover
- Comments are highlighted in amber
- Title bars and tabs now match the window's color
- Files in a colored space show that color in the sidebar
- The editor opens faster
- Word Count moved to the View menu
- Annotations button works while editing
Fixed
- Toggle Editor only changes the front window
- Documents no longer flash white when opening in dark mode
- Closing the sidebar no longer flashes a gray strip down the preview
- Settings opens centered
- The annotation toolbar no longer opens in an empty window
- Undo works after switching to another app and back
- Selected window tab is now remembered between relaunches
3.2 Sep 30
What's New in 3.1.1
- Sidebar and toolbar controls updated for macOS 27
- Formatting toolbar moved into the editor
- Fixed: Pin on Top menu item didn't light the toolbar button
- Fixed: Small windows could open partly off screen
- Fixed: Settings panes bounced with nothing to scroll
- Fixed: see-through Settings title bar on macOS 27
3.1.1 Sep 15
What's New in 3.1
- Annotations can now span paragraphs, list items, and table cells
- Option-click the copy button to copy plain text without the markdown
- Set the preview and Quick Look to light or dark, independently of your Mac
- Settings reorganized into seven tabs: Quick Look, Preview, and Rendering replace Behavior and Annotations
- Fixed: annotating across a line break in the source failed silently
- Fixed: a repeated phrase could be highlighted in the wrong place
- Fixed: annotation toolbar tooltips were English-only
3.1 Sep 10
What's New in 3.0
A new sidebar
Peekdown has a sidebar! Create a Space, name it, give it a color and an icon, then drag in your files and folders. Add files and folders to a Favorites section, and see your recents as well. Files in Spaces also double as a vertical tab bar for easy file switching.
Mermaid diagrams and math
Mermaid diagrams and LaTeX math render in the app and in Quick Look. Both work offline; there's nothing to install.
External changes
When a file changes outside Peekdown you get a banner instead of an alert, and you can see what changed before reloading. File > Show Changes… opens whichever diff is relevant — your unsaved edits against what's on disk, an external change you haven't dealt with, or what a reload just brought in. Saving won't overwrite a file that changed underneath you.
Undo
Undo covers the whole document now, including checkbox ticks, and typing groups into sensible steps.
Tabs
You can now switch between tabs with Cmd+1 through Cmd+9.
Editor
YAML frontmatter is highlighted, brackets and quotes auto-pair, and the footer shows a word count.
Finder icons
.md and .mdx files have their own document icons in the Finder.
Dark mode
Behavior settings let you choose the preview background used in dark mode.
Toolbar
The toolbar picks up the native look on macOS Tahoe.
Bug fixes
Annotations no longer carry over between files in a reused window. Cmd+W closes the tab in a tab group. Cmd+N honors your window-tabbing preference. Window size no longer snaps back after Raycast or other tools move it. Long editing sessions no longer grow memory.
3.0 Aug 3
What's New in 2.2.1
Bug fixes
- Fixed an issue where pressing Cmd+C in the preview could open a comment field instead of copying the selection.
- Fixed an issue where clicking a link to a heading with accented or non-Latin characters could fail to scroll to the heading.
2.2.1 May 11
What's New in 2.2
Quick Look display modes
Behavior settings now offers three Quick Look render modes: Full preview, Formatted source, and Plain text.
Cross-directory file links
Links to files in other directories now open correctly.
List-toggle shortcuts
Cmd+Shift+O/U/T now convert between list types instead of stacking markers.
MDX imports refresh reliably
External saves, file-watcher reloads, and Cmd+R now re-run MDX preprocessing.
Bug fixes
- Fixed an issue where the cursor would flicker when hovering over copy buttons in edit mode.
- Fixed an issue where the preview behind the editor could show stale content after leaving edit mode.
- Fixed an issue where the window could animate back to the wrong position when collapsing out of edit mode.
- Fixed an issue where clicking a broken file link showed two "not found" alerts instead of one.
- Fixed an issue where the block-note toolbar stayed open after using Clear All Annotations.
- Fixed an issue where clicking a local file link in the preview triggered an unnecessary sandbox permission prompt.
2.2 May 6
What's New in 2.1
MDX file support
.mdx files open natively. JSX components render in two modes — minimal (stripped) or enhanced (shown as code blocks) — configurable in Settings. Works with drag-and-drop, Quick Look, and the editor with full syntax highlighting.
Annotations can be turned off
New Behavior setting hides the annotation UI entirely for viewers who don't need markup.
Richer syntax highlighting
Code blocks now use highlight.js in the preview too, adding broader language coverage (including fish shell), better themes, and consistent rendering between editor and preview.
Working heading anchors
In-document links like #my-heading now jump where they should, using GitHub-style slugs.
Polish
Settings sidebar restyled with colored squircle icons; Launch and Behavior sections reorganized. Annotation action buttons rounded; inline code background matches GitHub dark exactly; fixed a top gap above the first heading when annotations are active.
2.1 Apr 24
What's New in 2.0
Annotations
Select any rendered text and mark it up with six annotation types — strike, comment, highlight, lock, note, and block notes for individual sections — then copy them as a structured prompt for any AI assistant. Annotations persist across sessions with JSON import and export.
Obsidian Vault Support
Callouts, highlights, wikilinks, tags, and embeds now render beautifully. Frontmatter and comments are automatically hidden.
Footnotes
References now render as superscript links with a numbered footnote section at the bottom, matching GitHub's style.
Built-in Help Book
New Apple-style Help Book with topic icons and context-sensitive links from Settings. Available in English, Spanish, German, and Japanese.
Also new: editor indent/outdent shortcuts, onboarding window, redesigned toolbar, title bar path menu, Quick Look copy button, and an empty preview placeholder for frontmatter-only files.
Bug fixes: fixed a crash from malformed markdown, a memory leak, macOS Sequoia permission dialogs, emoji editing issues, window size drift, and more.
2.0 Apr 11
Spanish Language Support
Peekdown now supports Spanish! All menus, settings, alerts, and the Quick Look extension are fully translated. The app automatically uses Spanish when your Mac is set to Spanish in System Settings.
Formatting Toolbar & Format Menu
A new formatting toolbar and Format menu make it easy to style your markdown without memorizing syntax. Bold, italic, strikethrough, inline code, headings, lists, blockquotes, and links are all one click or shortcut away. The toolbar toggles with Cmd+Shift+B and remembers your preference.
Print Support
Print your markdown documents with Cmd+P or File > Print. The print output is optimized for paper — clean black-on-white rendering, proper page breaks around code blocks and images, and no UI clutter.
Preview Zoom
Zoom now works in view mode! Use Cmd+/- to scale the preview, and Cmd+Shift+0 to reset zoom. In edit mode, both the editor and preview zoom together.
Keyboard Shortcut Updates
Formatting shortcuts now use familiar conventions: Cmd+B for bold, Cmd+I for italic, Cmd+K for link. Toggle Edit Mode has moved to Cmd+Shift+E, and Toggle Preview is now Cmd+Shift+P.
Table Column Alignment
Tables now respect alignment syntax. Use :--- for left, :---: for center, and ---: for right — just like GitHub.
Emoji Shortcodes
Type :rocket:, :heart:, :+1:, and ~200 other GitHub-style shortcodes to render emoji in your preview. Shortcodes inside code blocks and inline code are left as-is.
Settings Improvements
The "External changes" setting has been renamed to "Live reload" with clearer option labels — Never, Always, and Ask — so it's immediately obvious what each choice does.
Bug Fixes
- Fixed an issue where images with relative paths containing .. wouldn't display.
- Fixed an issue where Find bar search highlights could persist after dismissing the Find bar.
- Fixed an issue where apostrophes in image placeholder text were displayed as HTML entities.
1.5.1 Feb 20
Spanish Language Support
Peekdown now supports Spanish! All menus, settings, alerts, and the Quick Look extension are fully translated. The app automatically uses Spanish when your Mac is set to Spanish in System Settings.
Formatting Toolbar & Format Menu
A new formatting toolbar and Format menu make it easy to style your markdown without memorizing syntax. Bold, italic, strikethrough, inline code, headings, lists, blockquotes, and links are all one click or shortcut away. The toolbar toggles with Cmd+Shift+B and remembers your preference.
Print Support
Print your markdown documents with Cmd+P or File > Print. The print output is optimized for paper — clean black-on-white rendering, proper page breaks around code blocks and images, and no UI clutter.
Preview Zoom
Zoom now works in view mode! Use Cmd+/- to scale the preview, and Cmd+Shift+0 to reset zoom. In edit mode, both the editor and preview zoom together.
Keyboard Shortcut Updates
Formatting shortcuts now use familiar conventions: Cmd+B for bold, Cmd+I for italic, Cmd+K for link. Toggle Edit Mode has moved to Cmd+Shift+E, and Toggle Preview is now Cmd+Shift+P.
Table Column Alignment
Tables now respect alignment syntax. Use :--- for left, :---: for center, and ---: for right — just like GitHub.
Emoji Shortcodes
Type :rocket:, :heart:, :+1:, and ~200 other GitHub-style shortcodes to render emoji in your preview. Shortcodes inside code blocks and inline code are left as-is.
Settings Improvements
The "External changes" setting has been renamed to "Live reload" with clearer option labels — Never, Always, and Ask — so it's immediately obvious what each choice does.
Bug Fixes
- Fixed an issue where images with relative paths containing .. wouldn't display.
- Fixed an issue where Find bar search highlights could persist after dismissing the Find bar.
- Fixed an issue where apostrophes in image placeholder text were displayed as HTML entities.
1.5 Feb 18
Window Tabs
Combine multiple documents into a single tabbed window using Window > Merge All Windows. A new preference lets you choose whether new documents open in tabs or separate windows.
File Monitoring
Peekdown now detects when another application modifies, moves, or deletes your open file. Modified files can reload automatically, and deleted files prompt you to save elsewhere or keep editing.
Drop Files on Preview
Drag and drop markdown files directly onto the preview pane to open them. Depending on your tab preference, files open in a new tab or replace the current document.
Reorganized Settings
Window-related settings (tabs, reopen on launch, dropzone) are now in the General tab. The Editor tab combines theme and typography into a single Appearance section.
Find Dialog Fixes
Fixed issues where search highlights would persist after closing the Find dialog and appear corrupted when reopening.
Preview Mode Keyboard Fix
The editor no longer accepts keyboard input when hidden in preview-only mode. Previously, typing while proofreading could accidentally modify your document.
Polished View Menu
Menu items now have consistent icons and checkmarks. "Sync Scroll" displays an icon, and "Hide Preview" shows a checkmark when enabled.
Improved Image Placeholders
When an image can't be displayed — due to missing files or folder permissions — the placeholder now uses a clean, neutral design with themed icons instead of the previous bold amber styling. Placeholders share a uniform minimum width so they look consistent regardless of filename length.
Security Hardening
Added Content Security Policy for the preview, URL validation for links, and script tag filtering for inline HTML. These changes protect against potential injection when viewing untrusted markdown files.
Editor Syntax Highlighting
Code blocks in the editor now have full syntax highlighting with accurate color tokenization for 20+ languages including Swift, Python, CSS, JavaScript, and HTML.
Settings Sidebar Polish
The Settings sidebar now has larger icons, full-width click targets, and a new code icon for the Editor tab.
Window Stability
Fixed window position drifting after repeatedly creating and closing tabs, and window height shrinking when exiting edit mode with multiple tabs open.
1.3 Feb 9
Find and Replace
Search your documents with ⌘F. Navigate between matches, replace text individually or all at once. Options for case-sensitive and whole-word matching.
Copy Markdown Button
New toolbar button copies the entire document to your clipboard with one click.
Bug Fixes & Improvements
- Scroll sync toggle added to Settings
- Improved scroll sync behavior
- Improved performance when toggling edit mode
- Improved window positioning
- Fixed windows stacking on top of each other when opening multiple files
- Various stability improvements
1.2 Jan 31
Create New Files
Start fresh with Cmd+N. Create new markdown documents without opening an existing file first.
Interactive Checkboxes
Click checkboxes directly in preview mode to toggle them - no need to switch to edit mode. Enable optional auto-save to update your markdown file instantly. New reset button lets you uncheck all checkboxes at once.
llms.txt & humans.txt Support
Preview your llms.txt and humans.txt files with full markdown rendering. Context files for AI agents and contributor credits now look as good as your READMEs.
Bug Fixes & Performance
Fixed live preview updates, improved editor performance, and resolved settings dialog issues.
1.1 Jan 15
What's New in 3.3
- Colors you pick in Settings > Preview are now saved as swatches
- New option to hide the toolbar (Option-Command-T)
- New menu items for New Space, Copy Document and Reset Checkboxes
- Reworded View menu items for better consistency
Fixed
- Window sizes are remembered when exiting full screen
- Opening or closing the sidebar or editor in full screen no longer leaves the window too narrow or too wide afterward
- A new document opened in full screen no longer fills the screen after exiting
more Version 3.3 5d ago
Data Not Collected The developer does not collect any data from this app.