Markdown To

SpecificationsnormativeSheet 10 of 18

flashcards@0.1

A compact Markdown study guide that opens as a focused, keyboard-friendly deck with rich answers.

File
*.flashcards.md
Unit
question + answer
View
flip deck
Codes
MDTO1000–1099
Read agent skill · authoring and editorial guide

§ 01

A study deck that still reads like notes

Every level-2 heading is the front of a card. The blocks below it are the back: prose, lists, code, tables, and quotations stay useful in plain Markdown and become a composed answer in HTML.

Fig. 1Systems fundamentalsinteractive · offline
systems.flashcards.md
---
markdownto: [email protected]
title: Systems fundamentals
---

# Systems fundamentals

## What does idempotent mean?

Repeating the operation has the same effect as performing it once.

## Why use a write-ahead log?

It makes intended changes durable before the main data pages are updated.

## What are the three useful cache outcomes?

- hit
- miss
- stale value served while revalidating
rendered · flip deckkeyboard ready

Systems fundamentals

3 cardsflip to reveal each answerstudy deck

1 / 3

Click the card or press Space to flip · Arrow keys move through the deck

§ 02

One heading, one question, one honest answer

## Question?
Opens a card and names its front.
Following blocks
Become the answer until the next level-2 heading.
Document order
Is review order; no hidden scheduling state is invented.
Flip state
Presentation only. The Markdown is never rewritten.

§ 03

Review from a browser or a terminal

Verb

Meaning

Source edit

review

Lists prompts, or reveals one one-based card with --card.

None. Review state stays outside the canonical file.

§ 04

A broken deck never guesses its card boundaries

broken.flashcards.md
---
markdownto: [email protected]
---

##

An answer without a prompt.

## Repeated?

First answer.

### Too deep

## repeated?

Second answer.

## No answer

mdto validate

  • MDTO1001 error line 5

    ##

    Flashcard question is empty.

  • MDTO1003 error line 13

    ### Too deep

    Heading level 3 is not valid in [email protected]: use one leading # title and ## questions.

  • MDTO1002 error line 15

    ## repeated?

    Duplicate flashcard question repeated?: already declared on line 9.

  • MDTO1005 error line 19

    ## No answer

    Flashcard No answer has no answer content.

Read flashcards.md or run mdto spec flashcards for the complete contract.