Skip to main content
A reading lectern holding a fresh page, a lamp and a cup of tea on a stool, and loose pages drifting in the breeze. Ouro peeks over the lectern to read along.

Ouro MD · The Markdown app

Markdown that renders as you type.

Ouro MD renders Markdown in place as you type. Headings, tables, code, math, and diagrams become themselves — right where your cursor is. Just the document, staying honest about the Markdown underneath.

Latest release macOS 15+ Signed & notarized

Dramatization Lists and flowcharts render as you type.

The idea

Nice to write in. Nicer to read in.

Most Markdown editors make you pick a side: a raw source-code cave, or a decorative preview aquarium you can't type into. Ouro MD keeps the document a document. Syntax markers are there the moment you need them and quiet when you don't — so the page you write is the page you'd want to read.

  • Live in-place rendering (IR) — plus WYSIWYG and split, when you want them
  • Source Code Mode is one keystroke away (⌘/)
  • A distraction-free surface: no toolbar, just your words
Ouro MD rendering a table with emoji status, a KaTeX equation, and a checkbox task list. Ouro MD rendering a table with emoji status, a KaTeX equation, and a checkbox task list.

Features

The whole Markdown vocabulary — rendered, not previewed.

Everything a real document needs, in a real Mac app. Type it and watch it resolve in place.

  • Tables that behave

    Wide tables scroll inside their own block instead of dragging the page sideways.

  • Code, highlighted

    Fenced blocks with syntax highlighting and block-local scrolling — no runaway overflow.

  • Math, typeset

    Inline and display math rendered with KaTeX. $e^{i\pi}+1=0$ just works.

  • Diagrams

    Mermaid flowcharts, sequence, and more — drawn live, and re-themed for dark mode.

  • Four themes

    Quartz, Graphite, Manuscript, Newsprint — or drop in your own CSS.

  • Truly native

    Transparent titlebar, standard menus, Open Recent, drag-to-open, and auto-save.

  • Outline & search

    A live document outline, a folder file tree, and full-text folder search (⇧⌘F).

  • Export

    Save to themed, self-contained HTML or PDF. Images embed inline.

  • Yours, locally

    Plain files on your disk. Pasted images inline as data URIs — no upload server, no broken links.

Terminal install

One line, fully auditable.

The installer fetches the latest release, verifies its manifest and SHA-256 checksum against the published metadata, then installs the app. Magic you can read.

curl -fsSL https://ouroboros.bot/ouro-md-install.sh | bash
Also adds an md shell alias.