The editable document family

Three tools, one renderer. Each turns your Markdown into a single, self-contained, editable HTML file. Different shapes for different documents.

What they all share

One portable file

The Markdown source lives inside the file; it renders itself on open. Nothing to install to read it.

Edit in place

A built-in editor with live preview. Save writes back to the same file (in Chromium browsers).

Copy as Markdown

Select rendered content, copy, and get clean Markdown source back, ready to reuse anywhere.

Self-updating, opt-in

When a newer framework ships, the editor offers a one-click update from the canonical packages.

Offline or CDN

--inline embeds the engine and theme for offline use; --cdn makes a smaller file.

Verifiable

The embedded framework hashes against the published packages, so tampering is detectable.

.md.html

orz-mdhtml

A continuous document.

The classic article, README, or notes view, rendered for true WYSIWYG. The editor sits beside a live preview with optional scroll-sync, exactly like the one on this site.

  • Best for articles, documentation, notes, web-style reading.
  • Resizable split, theme switch, copy-as-Markdown.

orz-mdhtml on GitHub →

notes.md.html
Present from one file
  • Layout grammar & templates
  • Speaker view, fragments, timer
  • Runs in any browser
.slides.html

orz-slides

A reveal.js slide deck.

Present from a single file in any browser. A layout grammar (columns, splits, regions), structure templates (title, section, closing), and presenter tools: speaker view, step-reveal fragments, a timer, and slide numbers.

  • Best for talks, lectures, lightweight decks you can email.

orz-slides on GitHub →

.paged.html

orz-paged

A paginated print document.

Markdown laid out as pages with paged.js: A4 or Letter, margins, running headers and footers, page numbers. Edit side by side, then export to PDF by printing. No PDF binary, no server. Curated templates for articles, letters, CVs, reports, and exams.

  • Best for papers, reports, CVs, exams, anything destined for paper or PDF.

orz-paged on GitHub →

A Short Report
Yu Wang · 2026
1

Which one?

You want…Use
An article, note, README, or web-style document.md.html
To present slides from a single file.slides.html
A print or PDF document: paper, report, CV, exam.paged.html
Just to edit Markdown and keep the .mdthe editor
Editing and in-place Save need a Chromium-based browser (Chrome or Edge). Viewing, presenting, and printing work in any modern browser.