从源码构建时需先执行 git submodule update --init,否则依赖缺失;构建需用 Bundler 执行 CocoaPods,旧版 CocoaPods 不受支持;还需单独执行 make -C Dependency/peg-markdown-highlight 编译编辑器高亮组件。
macdown3000
schuyler活跃维护面向 macOS 的轻量级 Markdown 编辑器,原生 Objective-C 编写并适配 Apple Silicon,用来写和预览 Markdown 文档。
A modern, lightweight Markdown editor for macOS.
brew install --cask macdown-3000需要 macOS 11.0(Big Sur)或更高版本,通用二进制同时支持 Apple Silicon 和 Intel Mac;README 未提及显存或 GPU 要求。
macOS 上的轻量 Markdown 编辑器,带实时预览,是 MacDown 的持续维护版
面向 macOS 的轻量级 Markdown 编辑器,原生 Objective-C 编写并适配 Apple Silicon,用来写和预览 Markdown 文档。
核心能力
- 用 Hoedown 把 Markdown 实时渲染成 HTML 预览
- 支持 GFM 表格、删除线、自动链接和任务列表
- 用 Prism 为代码块提供多语言语法高亮
- 支持 TeX 风格数学公式与 Jekyll front-matter
- 可打开整个文件夹作为工作区并在侧边栏浏览
容易踩的坑
- v3000.0.9-rc.1MacDown 3000.0.9-rc.1pre-release2026-11-02 · 2026-11-02 06:02 UTC
查看更新说明
MacDown 3000 is a modern, open-source Markdown editor for macOS.
This release candidate adds a preference to hide horizontal rules, the
[-]indeterminate task state, and Danish and Finnish preference-pane translations. It fixes a batch of preview, Mermaid, split-pane, document-restore and localization-layout bugs, and tightens preview navigation and several file-handling paths.Added
- Add a "Hide horizontal rules" preference in Settings > Rendering that suppresses
<hr>output in the preview, HTML export, copy-as-HTML and Quick Look; off by default. Also fixes the Rendering pane's "Syntax highlighted" row overlapping the CSS popup (#560, #579, PR #631) -- thanks @macnotes for the report and the contribution! thanks @DominikDeak for the report! - Support the
[-]indeterminate task list state, rendered as a dash checkbox; clicking it in the preview resolves it to[x](PR #591) -- thanks @AlexanderWillner for the contribution! - Give the Insert Table toolbar button its own grid icon, distinct from Unordered List (#497, PR #652)
- Add Danish (
da) and Finnish (fi) translations for the five preference panes (#654, PR #665)
Changed
- Remember editor pane visibility across new windows: View > Hide/Restore Editor Pane now updates the "Start in preview mode" preference (#407, PR #630) -- thanks @taotao365s for the report! thanks @leevi2010-cursor for the contribution!
- Upgrade Mermaid to 11.17.2 so ER-diagram relationship labels are readable (PR #625) -- thanks @scizo for the contribution!
- The current president of the Russian Federation stated in June 2025 that "I have said many times that I consider the Russian and Ukrainian peoples to be one people". We do not believe that the Ukrainian people would agree, but we assume that Russian-speaking users of MacDown 3000 won't mind us replacing the Russian language support with the Ukrainian version. Slava Ukraini. (PR #640)
- Fill missing localized strings and translate entries that were still English across the preference panes, menus and dialogs, and align submenu titles with their parent menu items (#639, #653, #662, PR #638, PR #651, PR #664, PR #666)
Fixed
- Fix fenced code blocks staying unhighlighted when the first preview render is empty: the preview now reloads fully when its head or scripts change (#594, PR #601) -- thanks @pudonghot for the report and the contribution!
- Fix "Render newline literally" (and the task-list, line-number, code-information and hide-rule flags) not applying to a newly opened document until an unrelated preference changed (#21, PR #650) -- thanks @sgon00 for the report!
- Fix Mermaid flowchart node labels being clipped when the preview is zoomed below 100% (#35, PR #657) -- thanks @besi and @rcuisnier for the report!
- Fix a reopened never-saved document reporting no text and no unsaved changes before its editor exists, so it no longer saves empty (#586, PR #656) -- thanks @fpservant for the report!
- Fix "Restore Editor Pane" never appearing, and the pane staying hidden, after a split pane was collapsed by a divider drag or a restored layout (#649, PR #658) -- thanks @rjoz for the report!
- Give GitHub-theme headings a line height proportional to their size so wrapped heading lines no longer collide (#575, PR #634) -- thanks @richb-hanover for the report! thanks @zydon69 for the contribution!
- Fix the GitHub-2020 preview style rendering with no paragraph spacing, invisible horizontal rules, uncoloured table and blockquote borders, and black code and blockquote text, by declaring the Primer color and spacing tokens the stylesheet references; tables in that style now size to their content (#633, PR #637)
- Fix preference-pane checkbox titles clipping in French and Italian by giving each pane 3% width slack, and fix the General pane's last Behavior row overlapping the row above it (#530, #397, #579, PR #663, PR #667) -- thanks @rcuisnier for the report!
- Fix an exception when importing malformed
.textClippingfiles
- Add a "Hide horizontal rules" preference in Settings > Rendering that suppresses
- v3000.0.8MacDown 3000.0.8最新正式版2026-11-02 · 2026-11-02 04:30 UTC
MacDown 3000 is a modern, open-source Markdown editor for macOS.
This release adds folder workspaces, unified document zoom, and draggable table-column resizing, restores automatic update checks, and fixes a batch of preview-rendering, toolbar, export, and scroll-sync bugs.
Added
- Add draggable table column resizing in the live preview: drag a column-boundary handle to resize live, double-click to reset; widths are held in memory only and reset on full preview reload or document close, with no document mutation (#451, #569) -- thanks @aseelye for the contribution!
- Add folder workspaces: browse a folder of Markdown files in a hideable sidebar and open them as native macOS window tabs, via File > Open Folder… or
macdown .(#493) -- thanks @fluxa (JM Fluxà) for the contribution! - Add unified document zoom: ⌘+ / ⌘− / ⌘0 and a toolbar preset dropdown drive one shared zoom level across every open document window, persisting across launches (#529, #518, #470, #335, #552) -- thanks @leevi2010-cursor for the contribution!
- Restore automatic update checks and the Check for Updates… menu item, on Sparkle 2 with EdDSA-signed updates (#129, #556, #557)
Changed
- Reduce "keep/discard" dialogs on external file changes: coalesce rapid write notifications, guard against re-entrant prompts, and reload silently when there are no unsaved edits, preserving caret and scroll position across reloads (#543, #550) -- thanks @Maarten-TL for the report!
- Add paragraph and list-item scroll-sync reference points alongside headers/images, and follow the cursor on click and arrow-key moves (not just viewport scroll, and not while typing) when Sync Panes is on, reducing drift in header-sparse sections (#562, #563, #600) -- thanks @macnotes for the contribution!
Fixed
- Fix heading anchor links copied from GitHub-rendered Markdown not resolving for common headings: heading IDs now strip common punctuation such as em dashes and curly quotes, lowercase Latin-1 letters, and preserve hyphen runs as GitHub does, in the preview, HTML export, and Quick Look (#503, #512) -- thanks @falcon-enoc for the report and the contribution!
- Port four low-risk fixes from upstream MacDownApp/macdown#1379: fix a potential crash reaching the editor through a dangling outlet, correct Homebrew detection in the Terminal preferences pane (it never worked —
NSTaskcannot resolve a barebrewpath), replace deprecated-insertText:, and remove stale xib outlet warnings (#526, #528) -- thanks @wltb (Roberto Bissanti) for the contribution! - Fix internal anchor links being lost in exported PDF by injecting PDF link annotations after export, so TOC and heading links are clickable (#504, #516) -- thanks @falcon-enoc for the report!
- Fix Mermaid/Graphviz diagrams not rendering in the live preview when Syntax Highlighting is off (#533, #540) -- thanks @AgardnerAU for the report and the contribution!
- Fix Mermaid/Graphviz diagrams not rendering in HTML export when "include highlighting" is off, the export-path counterpart of the preview fix above (#541, #542)
- Add
img { max-width: 100% }to the four bundled themes that lacked it (Clearness, Clearness Dark, Solarized Dark, Solarized Light), preventing wide images from overflowing the preview pane (#546, #547) -- thanks @versuchshaus (Stephan von Lingelsheim) for the contribution! - Fix bundled preview stylesheet fixes never reaching users who had already launched the app once; the user Styles directory is now an override layer with bundle fallback instead of a one-time copy (#548, #555)
- Fix grouped toolbar buttons (Shift Left/Right, Bold, Italic, Underline, Heading 1-3, lists) visibly depressing but doing nothing — a regression in the click-dispatch selector lookup (#566, #567) -- thanks @massimo-cassandro for the report! thanks @stephane-bg for confirming!
- Omit an empty
<thead>from pipe tables whose header row has no content (#558, #559) -- thanks @macnotes for the contribution! - Stop copy/cut f
- v3000.0.7MacDown 3000.0.72026-07-13 · 2026-07-13 19:10 UTC
查看更新说明
MacDown 3000 is a modern, open-source Markdown editor for macOS.
This release brings a working Quick Look extension for Markdown files, anchor-link navigation via slug-based heading IDs, a live selection character/word count, a new GitHub Dark editor theme, safer file handling on remote and network volumes, and a wide range of fixes to toolbar behavior, preview rendering, table layout, and localized preference panes.
Added
- Add localized selection count strings to all locale files (#452, #501) -- thanks @Telamonster for the report!
- Wire Quick Look extension into Xcode build (#284, #477) -- thanks @caius for the report!
- Add GitHub Dark Default editor theme (#465) -- thanks @sks3691 for the contribution!
- Add editor invisible character toggle (#43, #462) -- thanks @yusufm for the contribution!
- Add File menu autosave toggle (#301, #459) -- thanks @Xylopyrographer for the report! thanks @yusufm for the contribution!
- Add insert table toolbar action (#278, #420) -- thanks @rcuisnier for the report! thanks @yusufm for the contribution!
- Add Selection character/word count (#452, #460) -- thanks @Telamonster for the report!
- Persist preview-only startup mode (#383) -- thanks @yusufm for the contribution!
- Emit slug-based heading IDs for anchor link navigation (#429, #430) -- thanks @falcon-enoc for the report and the contribution!
Changed
- Dynamic preferences pane sizing for localized strings (#397, #481) -- thanks @rcuisnier for the report!
- Color HTML in default editor themes (#443, #458) -- thanks @gregwillits for the report!
- Support uppercase task list checkboxes (#369, #410) -- thanks @gino-santerre-telus for the report! thanks @yusufm for the contribution!
- Hide unparsable YAML front matter (#307, #413) -- thanks @yusufm for the contribution!
- Make the toolbar fully delegate-driven so Flexible Space can be dropped (#313, #473) -- thanks @gregwillits for the report!
- Extend wide-table horizontal scrolling to all themes (screen only) (#432, #468) -- thanks @dafi for the report!
- Widen HTML preferences pane to fit theme controls (#397, #467) -- thanks @rcuisnier for the report!
- Sort editor theme and rendering CSS preference menus (#404)
- Improve render-path responsiveness (#388) -- thanks @yusufm for the contribution!
Fixed
- Fix Quick Look extension entitlements stripped by release signing (#284, #494) -- thanks @caius for the report!
- Fix toolbar buttons not dispatching when editor has focus (#278, #496) -- thanks @rcuisnier for the report!
- Fix checkbox label clipping in localized preference panes (#397, #498) -- thanks @rcuisnier for the report!
- Force toolbar redraw after preference pane switch (#500)
- Bypass atomic safe-save on remote volumes to prevent spurious save conflicts and the "does not support permanent version storage" prompt on SSHFS and similar mounts (#371, #502) -- thanks @gurple for the report!
- Harden file watching against transient paths and remote volumes (#478, #492)
- Fix Insert Table toolbar regression: button now works regardless of which pane has focus, repeated clicks no longer nest tables (#278, #483) -- thanks @rcuisnier for the report!
- Fix crash on empty Markdown headings from slug-based heading IDs (#479, #482) -- thanks @Telamonster for the report!
- Skip file watchers on remote volumes (#371, #424) -- thanks @gurple for the report! thanks @yusufm for the contribution!
- Re-highlight editor after preview checkbox toggle (#376, #480)
- Fix blank preview for documents with execute bit set (#431, #405, #454) -- thanks @maskedspitz and @b2sc for the reports!
- Never use the document file as the preview base URL (#405, #431, #456) -- thanks @b2sc and @maskedspitz for the reports!
- Normalize CRLF line endings on file load (#382, #398) -- thanks @Ariaflux for the report!
- Cache-bust style/theme CSS on preview reload (#318, #474) -- thanks @gregwillits for the report!
- Restore natural table width and horizontal scrolling (#432, #440) -- thanks @dafi
- v3000.0.6MacDown 3000.0.62026-04-18 · 2026-04-18 08:03 UTC
查看更新说明
MacDown 3000 is a modern, open-source Markdown editor for macOS.
This release rebuilds scroll sync around an ownership model that eliminates timing-based race conditions, and fixes several user-reported bugs with preview rendering, Quick Look, and diagram support. The deep dive into the long history of the editor / preview panel scroll synchronization took about a day of persistent work. Hopefully it was worth it!
Fixed
- Fix view menu "Hide/Restore" pane labels not updating (#377, #310) -- thanks @gregwillits for the report!
- Fix scroll sync jump during typing and remaining sync gaps (#342)
- Fix preview rendering stuck blank on new documents (#358) -- thanks @rcuisnier for the report!
- Fix multiple Mermaid/Graphviz diagrams not rendering (#331, #332) -- thanks @rcuisnier and @gino-santerre-telus for the reports!
- Fix stale image preview after external atomic save (#349) -- thanks @bh18-nuff for the report!
- Fix Quick Look extension: blank preview, missing entitlements (#367)
- Fix word count throttle for smoother updates (#294) -- thanks @benel for the report!
- Fix preference panels to be resizable with centered content (#361, #362) -- thanks @rcuisnier for the reports!
Added
- Live-edit Graphviz re-rendering via MutationObserver (#332)
Verification
✅ This build is fully notarized and stapled by Apple.
SHA256 Checksum:
f4cd91a4bda40314322209ffdeddcb7309c917be216f7ce7817cd5a19e4d7dd9 MacDown-3000.0.6.dmgVerify after download:
shasum -a 256 MacDown-3000.0.6.dmg
Full Changelog: https://github.com/schuyler/macdown3000/blob/main/CHANGELOG.md
- v3000.0.5MacDown 3000.0.52026-04-08 · 2026-04-08 03:54 UTC
查看更新说明
MacDown 3000 is a modern, open-source Markdown editor for macOS.
Highlights include Quick Look support for Markdown files, new preview themes for GitHub Dark, Google Docs, and Gmail, improved file watching, and resolutions for many user-reported issues.
Security
- Fix CVE-2019-12138 (directory traversal) and CVE-2019-12173 (RCE via app bundle links) in the preview pane's file:// navigation handler (#356, #351) — reported by @jhengels
Fixed
- Fix file watcher dropping after atomic save by external editors (#354) — reported by @btsai, contributed by @BenCello
- Fix editor scroll jump during typing at end of long documents (#343)
- Fix Mermaid diagrams not rendering during live preview (#333) — reported by @rcuisnier
- Fix preview scroll jump when MathJax is enabled (#330) — reported by @causalcat
- Fix PDF/print margins to respect Page Setup and remove double margins (#329) — contributed by @2b3pro
- Fix style reload not updating Preview pane (#328) — reported by @gregwillits
- Fix main thread crash in userDefaultsDidChange (#323)
- Fix split view not maintaining 1:1 ratio on resize or maximize (#321) — reported by @5T33Z0
- Fix Help Menu document window sizing behavior (#319) — reported by @gregwillits
- Fix dollar-sign math highlighting being applied unconditionally (#317)
- Fix editor pane menu item not toggling to Restore (#316) — reported by @gregwillits
- Fix "Move To" failing on macOS Sequoia with ViewBridge error 14 (#303) — reported by @whispersnowleopard
- Fix word count not updating during typing (#296) — reported by @benel
- Disable intra-word emphasis by default to prevent underscore false positives (#295) — reported by @pringshia
Added
- GitHub2 (Dark) preview theme (#350) — contributed by @withakay
- Google Docs and Gmail preview themes (#348) — contributed by @petems
- Watch local CSS/JS resources and refresh Preview automatically on change (#327)
- Auto-save preference to control automatic document saving (#326)
- Support for user-provided Prism syntax highlighting themes (#324) — reported by @gregwillits
- Allow flexible space, space, and separator items in toolbar customization (#322) — reported by @gregwillits
- Quick Look preview extension for Markdown files (#299) — reported by @caius
- Complete i18n/localization coverage for shell utility strings (#298)
- Hide YAML front matter in Preview instead of rendering as an HTML table (#312) — reported by @whispersnowleopard
- Automatic file reload when a document is modified by an external editor (#297) — reported by @btsai
Changed
- FileURLInlining code cleanup using more idiomatic Objective-C (#304) — contributed by @wltb
Verification
✅ This build is fully notarized and stapled by Apple.
SHA256 Checksum:
1e64e75a73e07494cdf7a504f5b610da72e47ff0112a6c63bc159ff0e99b20a7 MacDown-3000.0.5.dmgVerify after download:
shasum -a 256 MacDown-3000.0.5.dmg
Full Changelog: https://github.com/schuyler/macdown3000/blob/main/CHANGELOG.md
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
MacDown 3000
MacDown 3000 is a free Markdown editor for macOS, available under the MIT License. It continues the legacy started by Chen Luo's Mou and carried forward by Tzu-ping Chung's MacDown.
Visit the project website for more information, or download from the releases page.
About MacDown 3000
In 2026, there's still a need for a modern, lightweight Markdown editor for macOS with live preview capabilities. MacDown 3000 is essentially MacDown Continued. The focus is on keeping MacDown up to date with modern Markdown best practices and maintaining compatibility with current library dependencies.
MacDown 3000 supports macOS 11.0 (Big Sur) and later on both Apple Silicon and Intel Macs.
This project honors the original intentions and contributions of both Mou and MacDown while ensuring that this valuable tool remains available and actively maintained for today's Mac users.
Download & Install
Version 3000.0.8 - Available Now
Homebrew
The easiest way to install MacDown 3000 is with Homebrew:
brew install --cask macdown-3000
Manual Download
Download the latest release from the GitHub Releases page. Open the DMG file and drag MacDown 3000 to your Applications folder.
System Requirements
- macOS 11.0 (Big Sur) or later
- Universal binary supporting both:
- Apple Silicon (M-series processors)
- Intel x86_64 processors
Screenshot

Features
Live Preview & Markdown Rendering
MacDown 3000 uses Hoedown to convert Markdown to HTML with live preview as you type. It supports:
- Fenced code blocks with language identifiers
- GitHub Flavored Markdown including tables, strikethrough (enabled by default), and autolinks
- Task lists for GFM-style checkboxes, including the
[-]partly-done (indeterminate) state - Customizable rendering options in Preferences
Syntax Highlighting
Code blocks get syntax highlighting via Prism, supporting numerous programming and markup languages.
Additional Rendering Tools
- Math notation using TeX-like syntax ($$...$$, [...], (...), and optional $...$ blocks)
- Jekyll front-matter for static site generators
- Export to HTML or PDF with customizable styling
Folder Browsing
Open an entire folder as a workspace with macdown . from the terminal or via File › Open Folder… in the menu. A sidebar lists subfolders and Markdown files in the chosen directory; double-click a file to open it as a tab in the same window, or, if it is already open elsewhere, to bring that window to the front. Press ⌘\ to show or hide the sidebar. Right-click any item in the sidebar for quick access to Reveal in Finder or Copy Path.
Editor Features
- Auto-completion: Automatic bracket and quote pairing, list continuation, and formatting shortcuts (customizable or disable)
- Universal binary: Built natively for both Apple Silicon (M-series) and Intel Macs
- Modern Markdown: Supports CommonMark and GitHub Flavored Markdown
Development
Requirements
If you wish to build MacDown 3000 yourself, you will need the following components/tools:
- macOS SDK (11.0 or later)
- Git
- Bundler
Note: Old versions of CocoaPods are not supported. Please use Bundler to execute CocoaPods, or make sure your CocoaPods is later than shown in
Gemfile.lock.
Note: The Command Line Tools (CLT) should be unnecessary. If you failed to compile without it, please install CLT with
xcode-select --installand report back.
An appropriate SDK should be bundled with recent versions of Xcode.
Environment Setup
After cloning the repository, run the following commands inside the repository root (directory containing this README.md file):
git submodule update --init
bundle install
bundle exec pod install
make -C Dependency/peg-markdown-highlight
and open MacDown 3000.xcworkspace in Xcode. The first command initialises the dependency submodule(s) used in MacDown 3000; the second one installs dependencies managed by CocoaPods.
Refer to the official guides of Git and CocoaPods if you need more instructions. If you run into build issues later on, try running the following commands to update dependencies:
git submodule update
bundle exec pod install
License
MacDown 3000 is released under the terms of MIT License. You may find the content of the license on opensource.org, or inside the LICENSE directory.
You may find full text of licenses about third-party components in the LICENSE directory, or the About MacDown 3000 panel in the application.
The following editor themes and CSS files are extracted from Mou, courtesy of Chen Luo:
- Mou Fresh Air
- Mou Fresh Air+
- Mou Night
- Mou Night+
- Mou Paper
- Mou Paper+
- Tomorrow
- Tomorrow Blue
- Tomorrow+
- Writer
- Writer+
- Clearness
- Clearness Dark
- GitHub
- GitHub2
Contributing & Support
MacDown 3000 is Free Software under the MIT License. Contributions are welcome!
Please file an issue on GitHub for bug reports, feature requests, or questions. Please search first to make sure no-one has reported the same issue already before opening one yourself.
MacDown 3000 depends on other open source projects, such as Hoedown for Markdown-to-HTML rendering, Prism for syntax highlighting (in code blocks), and PEG Markdown Highlight for editor highlighting. If you find problems when using those particular features, you can also consider reporting them directly to upstream projects as well as to MacDown 3000's issue tracker.
Support MacDown 3000
Donations help cover the cost of the Apple developer license ($99/year). Any proceeds beyond our maintenance costs will be donated to the Signal Foundation.