ReviveMD

ReviveMD turns one Markdown file into a standalone HTML document. I made it for work that needs to stay easy for an agent to read but should look finished when I send it to a person.

The source uses GitHub Flavored Markdown with a fixed set of additions for code, math, diagrams, tabs, tooltips, and callouts. The goal is to create a markdown system that any agent can write without needing documentation or skills, so we work with existing markdown standards, we do not invent a new syntax, and we do not require any special knowledge to use the features.

I wanted to make this project because I am increasingly noticing people saying that they have their agents create HTML instead of markdown. I find this interesting since Markdown was made to make it easier to create HTML, so we have regressed in a way. But I agree, normal markdown is hard to make look good, and I wanted to make a tool that would make it easier to create good-looking HTML from Markdown without requiring the user to know HTML or CSS. Also this saves a lot on tokens!

Features

• check, render, and live-reloading preview commands
• Syntax-highlighted code, math, diagrams, tabs, tooltips, and callouts
• Standalone output with embedded CSS, fonts, icons, themes, and browser code
• Built-in presentation styles or a snapshot of the active RiceKit theme

One portable file

Comrak parses Markdown, Syntect highlights code, and Ammonia cleans raw HTML. ReviveMD embeds its CSS, fonts, icons, theme, and browser code in the result. The reader does not need ReviveMD, Node, Python, or a network connection.

Keeping the output self-contained forced several useful limits. ReviveMD has a closed feature set rather than third-party code plugins. Raw HTML always goes through the sanitizer. Browser code adds presentation after rendering instead of owning the document model. Playwright tests open completed files and check the parts that unit tests cannot see.