Render here.
Build anywhere.

One mdto command serves every format. Read the spec, validate the file, and render an HTML page. Format-specific commands handle the operations each spec supports.

mdto spec kanban
mdto validate launch.md
mdto render launch.md -o launch.html
mdto kanban --help

Run from source

The repository includes the CLI, renderers, and conformance tests. You need Node.js 20 or newer and pnpm.

git clone https://github.com/seekinggradient/markdownto.git
cd markdownto
pnpm install
pnpm build
node packages/cli/dist/main.js --help

Use node packages/cli/dist/main.js in place of mdto in these examples, or point a local command at it. See the repository for setup and distribution updates.

mdto render creates a standalone HTML document with its styles included. Publish that file with your site, link to it, or embed it in an iframe.

mdto render launch.md -o public/launch.html --no-source

<iframe
  src="/launch.html"
  title="Launch plan"
  sandbox="allow-scripts allow-downloads"
  style="width:100%; height:640px; border:0"
></iframe>

That embeds the generated document. Changes to the Markdown need a new render, just like other files in a static site build.

Interactive views

Some exports include their own interactions, such as a timer or a study session. A live board that writes changes back to a source file needs the live renderer and a host that handles those edits. Embedding a static export does not automatically save changes to your repository.

The repository’s web package provides the renderers and host integration contracts. It is currently a workspace package; it is not a published npm dependency.

The specification defines the file. Its companion skill teaches authoring and editorial judgment. The CLI validates, renders, and applies supported changes. These are three parts of one toolkit.

Read https://markdownto.ai/llms.txt.
Choose the format that fits my request, then read its
specification and companion skill. Create the Markdown,
validate it with mdto, and render the result.

Find a spec and skill or start with the CLI.

Generating speech is a separate step from rendering HTML. Gemini audio requires a configured service or provider; this site connects through agentsFS Hub. An HTML export does not include that hosted account connection.

Guided narration also needs the source article or capture to resolve its passages. You can import it in the reader; the article is not automatically fetched from a website address. Computer voice depends on browser and operating-system support.

For guided narration, choose Prepare offline in the reader, then Download offline. The single HTML file includes the captured article, embedded illustrations, player, and recorded audio. Open it in a browser without signing in or connecting to the narration service. Preparing new audio requires a Hub connection.

Read the narration spec and guided narration spec for their full contracts.