Markdown is suddenly everywhere.
It’s how we speak to machines now. It’s how they speak to us.
We should make it nice!
But you already have a favorite text editor. You don’t need a special tool for writing Markdown. You just need a way to preview the Markdown you’re writing, marked up.
That’s what Mud is for. It renders Markdown beautifully, bright or dark. It automatically reloads the document when you save it — or when Claude Code writes to it, or Codex, or whatever you use.
Mud shows you both sides of every document:
- Mark Up renders your Markdown as styled HTML — GitHub-flavored, with syntax-highlighted code.
- Mark Down shows the raw source with line numbers.
Hit Space to flip between them. Your scroll position carries over.
Mud is a Mac-gassed Mac app with excellent command-line tooling. It’s free and it’s open source.
It does one thing — it marks up Markdown! — and it does it really well.
*Comments!* — Select any passage and attach a threaded comment, perfect for marking up a document for a coding agent or a colleague. Comments live inside the Markdown file itself as standard footnotes, so they travel with the file and stay readable in any other tool. Replies, edits, and deletes are all supported.
*Footnotes* — Mud now renders Markdown footnotes. Clicking a reference marker opens a popover with the footnote body rendered as Markdown, and Down mode highlights footnote definitions and markers.
And more:
* Hover over the document title in the toolbar to reveal the file proxy icon.
* Toolbar button icons have tooltips.
* The Changes bar and Find bar now sit side by side when bottom-centered.
Version 3.0.0
The developer, Joseph Pearson, indicated that the app’s privacy practices may include handling of data as described below. For more information, see the developer’s privacy policy .
Data Not Collected
The developer does not collect any data from this app.
Privacy practices may vary, for example, based on the features you use or your age. Learn More
Accessibility
The developer has not yet indicated which accessibility features this app supports. Learn More