Markdown To

SpecificationsnormativeSheet 15 of 18

form@0.1

Ask clearly. Keep the answers.

A focused questionnaire whose typed responses travel in the same readable Markdown file.

File
*.form.md
Unit
question
View
fillable response
Codes
MDTO1500–1599
Read agent skill · authoring and editorial guide

01

Ask clearly. Keep the answers.

A focused questionnaire whose typed responses travel in the same readable Markdown file.

A real conforming file, rendered by the same engine as the CLI.
Read the example Markdown
---
markdownto: [email protected]
title: Start with the right questions
---

## Your name

[type:: text] [required:: true]

The person we should work with.

## Email address

[type:: email] [required:: true]

Where can we send a follow-up?

## What are you making?

[type:: long-text] [required:: true]

Describe the change you want to create, the people it serves, and what success looks like.

## Project stage

[type:: select] [required:: true]

- exploring: Exploring an idea
- building: Building the first version
- improving: Improving something people already use

## What would help?

[type:: multiselect]

- strategy: A clearer direction
- design: Product and visual design
- engineering: Implementation and delivery

## Team size

[type:: number] [min:: 1] [max:: 1000]

## Preferred start date

[type:: date]

## May we follow up?

[type:: boolean] [required:: true]

Try the full form workflow →

02

One clear meaning for every section

A level-2 heading is a question. 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.form.md
mdto render example.form.md
mdto form --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]
---

## Choose

[type:: select] [required:: sometimes]

- a: First
- b: Second

  1. MDTO1502 error line 5

    ## Choose

    required must be true or false.