# Flashcards from Markdown, CSV or Anki Text

> Turn notes into flashcards: Q:/A: pairs, term :: definition lines, cloze gaps, CSV or Anki text. Reads study notes and makes flashcards with stable ids: Markdown “Q:”/“A:” pairs, “term :: definition” lines (“:::” adds the reverse card), {{c1::cloze}} gaps with optional hints (one card per gap number, like Anki), # headings as tags, CSV or tab-separated rows, an Anki “Notes in Plain Text” export (HTML turned into text) or a Deckwright slide deck (slide titles become questions). Returns the cards, a CSV file, the cards as editable Markdown and a link that opens them in Deckwright’s Study view.

Part of usefulweb.site (https://usefulweb.site/). Part of [Deckwright](https://deckwright.usefulweb.site/) (ownerApp: deckwright). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://deckwrightcardsfrommarkdown.usefulweb.site/ (interactive tool at https://deckwrightcardsfrommarkdown.usefulweb.site/tool)
- JSON API: POST https://deckwrightcardsfrommarkdown.usefulweb.site/api/v1/calculate with a JSON object of inputs (schema: https://deckwrightcardsfrommarkdown.usefulweb.site/api/v1/tool)
- OpenAPI: https://deckwrightcardsfrommarkdown.usefulweb.site/openapi.json
- MCP (Streamable HTTP): https://deckwrightcardsfrommarkdown.usefulweb.site/mcp - tool `deckwright_cards_from_markdown`

## Inputs
- text (textarea): Cards - Markdown: “Q:” and “A:” lines, “term :: definition” (“:::” also makes the reverse card), {{c1::cloze}} gaps, # headings as tags. Or CSV/TSV rows (front, back, tag), an Anki plain-text export, or a slide deck.
- format (select): Format
- reverse (boolean): Also make reverse cards (answer → question)
- lang (text): Card language (BCP 47, e.g. en, es, ja) - Used for answer checks and fonts; empty = English.

## Method
- Markdown: a line “Q:” starts a question, “A:” its answer (several lines; a blank line ends the card). “front :: back” lines make one card, “front ::: back” two (both directions). Paragraphs with {{cN::answer}} or {{cN::answer::hint}} make one cloze card per number N: that gap shows […] or [hint], the other gaps show their text. # headings tag the cards below them.
- CSV and TSV follow RFC 4180 (quoted fields may hold commas, tabs and line breaks); a first row named front/back, question/answer or term/definition is a header, a third column or a column named tag becomes the tag. Anki text exports honour #separator, #html, #columns and the #notetype/#deck/#guid/#tags column headers; HTML line breaks are kept, bold and italic become Markdown, pictures become their file name.
- A slide deck gives one card per content slide with a title: the title is the question, the slide text (lists, tables, quotes, chart and diagram descriptions) the answer; # section slides tag the cards after them; speaker notes stay out.
- Card ids are “b-”, “r-” (reverse) or “cN-” (cloze) plus the FNV-1a hash of the question (of the full sentence for cloze cards), so editing an answer keeps the card’s review history; repeated questions get -2, -3 ….

## Limits
- Anki .apkg packages (SQLite) are not read; export the notes from Anki as “Notes in Plain Text” instead. Pictures inside an Anki text export cannot be carried over.