Markdown To

SpecificationsnormativeSheet 16 of 18

epub@0.1

A book that travels with you.

Chapters, metadata, images, and navigation become a reflowable EPUB without surrendering the manuscript.

File
*.epub.md
Unit
chapter
View
reader + EPUB
Codes
MDTO1600–1699
Read agent skill · authoring and editorial guide

01

A book that travels with you.

Chapters, metadata, images, and navigation become a reflowable EPUB without surrendering the manuscript.

A real conforming file, rendered by the same engine as the CLI.
Read the example Markdown
---
markdownto: [email protected]
title: A field guide to attention
author: Alex Rivera
language: en
identifier: urn:mdto:attention-field-guide
---

## The first quiet minute

A good observation begins before the explanation. Take a breath, look around, and write what you can actually see.

### Separate seeing from guessing

**Observation:** a person returns to the same page three times.

**Interpretation:** perhaps the page is difficult to understand.

These are different kinds of statements. Keep both, and label them honestly.

> Curiosity is a practice before it becomes an insight.

## A notebook that travels

A portable note can be opened, copied, and understood without the application that created it.

- Name the question.
- Record the evidence.
- Keep uncertainty visible.

### A small experiment

| Day | Practice |
| --- | --- |
| Monday | Notice one repeated action |
| Tuesday | Ask one open question |
| Wednesday | Compare what you expected with what happened |

## Return to the question

The point of a notebook is not to finish it. It is to become better at noticing what matters.

Read the [first chapter](#chapter-1) again with a new question.

Try the full epub workflow →

02

One clear meaning for every section

A level-2 heading is a chapter. The canonical specification defines the precise structure, validation rules, and source-preservation guarantees. The companion skill teaches agents how to create useful content within that contract.

Read [email protected] · Read the authoring skill

03

A file, a renderer, and precise operations

Validate after authoring. Open the file as an application. Use the spec-owned verbs for deterministic operations and inspect their machine-readable results.

mdto validate example.epub.md
mdto render example.epub.md
mdto epub --help

Every saved answer or weight stays in the Markdown. Publication exports preserve the authored content. No renderer invents missing facts.

04

Refuse ambiguity. Explain the repair.

---
markdownto: [email protected]
language: not_a_language
---

## Hello

Text.
  1. MDTO1602 error line 3

    language: not_a_language

    Use a language tag such as en or en-GB.