Welcome to YD MD. This file is rendered by the app, offline, while the page around it uses the same four themes.
Note
Math, diagrams and alerts render without a single network request.
Level
Syntax
Result
1
# Heading
Heading 1
2
## Heading
Heading 2
func hello() {
print("Hello, Markdown!")
}
Search as you type
Every match is counted while you type, then you step through them with the keyboard. This is the app's real search field, running on a real sample file.
4 matches in Getting Started.md
8It works offline, with every renderer bundled in the app.
19No telemetry, no analytics: the reader stays offline unless a document names a remote image.
31Remote images stay blocked, so the page stays offline until you allow them.
Try⌘F in the app, ⌘G for the next match.
A whole document, not a preview
The outline, search, zoom and export sit around the page, not on top of it. One window holds the whole file.
Outline. Follows the heading you are reading.
Search. Every match counted, next and previous.
Export. PDF, print, or one standalone HTML file.
Speed. A five megabyte file still scrolls.
Getting Started.md in the GitHub theme, with the outline open. Screenshot from YD MD 1.0.
Inside the reader
The parts that matter when a file runs to a hundred thousand lines.
KaTeX sets inline and block math. Mermaid draws flowcharts, sequence, class, state, ER, gantt, pie, git and mind maps. Both run locally, from files inside the app.
Tables, task lists, footnotes, definition lists, front matter and GitHub alerts arrive as they were written. Code blocks carry the language, the highlight and a Copy button.
Set the page the way you read
GitHub, GitHub Dark, Sepia and High Contrast, each one following the system or staying fixed. The control in the first screen is the same switch, applied to this page.
Font, size, content width and line height are sliders, not a config file. Every change is kept, so the next file opens the way you left the last one.
Private by design
No telemetry, no analytics, no network requests other than the images a document names. Block remote images and not one byte leaves the Mac.
The app runs sandboxed with the hardened runtime, and files open read-only. Task checkboxes only write back when you switch that on, one atomic change at a time.
Tested against the spec
The conformance suites ship with the project. Run them yourself with one command.
652 / 652
Every CommonMark 0.31.2 example passes
GFM
654 of 672, 18 documented differences
KaTeX
Inline and display math
Mermaid
Nine diagram types
Sandboxed
Hardened runtime, read-only by default
No telemetry
No account, no analytics
Offline
Every renderer bundled
Before you install
Free. No account, no subscription, no in-app purchase. YD MD 1.0 is a download from GitHub.
Yes. The parser, KaTeX, Mermaid, highlight.js and every theme are inside the app. The only network request is an image a document points to, and Block remote images turns that off.
macOS 13 Ventura or later. The 1.0 build is Intel, x86_64. On Apple silicon it runs through Rosetta 2.
No. Documents open read-only. If you turn on Allow toggling task list checkboxes, changing a box writes that one change back atomically.
The 1.0 build is signed ad hoc, not notarized. Right-click the app in Applications, choose Open, then Open again. macOS remembers the choice.
Yes. YD MD registers the Markdown document types. Select a .md file in Finder, choose Get Info, then Open with and Change All.
CommonMark 0.31.2 in full, GitHub Flavored Markdown, and the extensions people use: footnotes, definition lists, front matter, math, Mermaid, alerts, task lists and code highlighting.
The source lives in a private repository. The public repository carries the build, the README and the issue tracker.
Free. No account, no subscription, no in-app purchase.
Open one file. See everything.
Download YD MD 1.0, drag it to Applications and open your first Markdown file. Every renderer is already inside.