Markdown To

SpecificationsnormativeSheet 18 of 18

quiz@0.1

Understand what you know.

Questions, answer keys, and explanations become a self-study assessment with a portable attempt.

File
*.quiz.md
Unit
question
View
assessment
Codes
MDTO1800–1899
Read agent skill · authoring and editorial guide

01

Understand what you know.

Questions, answer keys, and explanations become a self-study assessment with a portable attempt.

A real conforming file, rendered by the same engine as the CLI.
Read the example Markdown
---
markdownto: [email protected]
title: Think like a systems designer
pass: 75
---

## What makes an operation idempotent?

[type:: select] [correct:: repeat] [points:: 2]

- fast: It always completes quickly.
- repeat: Repeating it has the same effect as doing it once.
- async: It runs in the background.

### Explanation

Idempotence is about the effect of repetition. Setting a value to 5 is idempotent; incrementing it is not.

## Which actions preserve a portable source of truth?

[type:: multiselect] [correct:: export,validate] [points:: 2]

- export: Save meaningful state in a readable file.
- hidden: Keep important answers only in browser storage.
- validate: Validate edits before committing them.

### Explanation

A portable file must carry the meaningful state. Validation helps ensure that another tool can interpret it consistently.

## What should happen when a saved file has changed?

[correct:: conflict]

- overwrite: Overwrite it with the old version.
- conflict: Report the conflict and preserve both versions.
- ignore: Pretend the save succeeded.

### Explanation

An expected source hash makes conflicting edits visible instead of silently losing someone else's work.

Try the full quiz 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.quiz.md
mdto render example.quiz.md
mdto quiz --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] [correct:: a]

- a: First
- b: Second

  1. MDTO1802 error line 5

    ## Choose

    required must be true or false.