ankcompiler 0.2.0

A CLI tool for compiling Anki decks, defined in Markdown

AnkCompiler

A CLI tool for compiling Anki decks, defined in Markdown.

Installation

Run pip install ankcompiler

Usage

Run ankc --help for usage information.

Main commands:

• ankc build compiles decks into .apkg packages.
• ankc check validates decks without compiling. It reports problems as file:line, and can print JSON with --format json.
• ankc uid adds a [^uid] footnote to any card block that is missing one. It is safe to run more than once. Use --check for a dry run. It will not touch files with uncommitted git changes unless you pass --force.

Examples

See examples/example.md for a deck with every note type, tags, and math.

Note types

• Question and answer: front ::: back. Found automatically.
• Cloze: {{c1:: ...}}. Found automatically.
• Basic and reversed: front ::: back plus [^type]: reversed. This makes a card in both directions.
• Type in the answer: question ::: answer plus [^type]: type-in.

Reversed and type-in cards use the same ::: syntax as a question and answer card. So you name them with a [^type] footnote next to the [^uid].

Math

Write inline math as $...$ and block math as $$...$$. Anki renders it with MathJax. To show a real dollar sign, write \$.

Credits

Inspiration taken from lukesmurry