Skip to main content

Command-line tool for adding flashcards from Markdown files to Anki

Project description

inka2

Downloads PyPi Tests CI Codecov

Automatically extract flashcards from Markdown to Anki.

too useful to let it be unsupported :-)

Installation

Install inka2:

python3 -m pip install inka2 --upgrade

Requirements

Why

I've been using Anki for a long time, and at some point my notes turned into just lists of question/answer pairs, from which I then created Anki cards. The process of creating flashcards in Anki took a long time, so I decided to write a Python script to automate it. With more and more features added, the script has evolved into the command-line tool you can see now.

inka2 allows you to use full power of Markdown when creating flashcards. The program is also extensively tested.

Features

Usage

Creating Cards

In order for the program to be able to separate cards from all the rest of the text in the file, you need to enclose them between two ---:

---

Deck: Life Questions

Tags: learning life-questions

1. What is the answer to the Ultimate Question of Life, the Universe, and Everything?

> 42

2. If it {{c1::looks like a duck, swims like a duck, and quacks like a duck}}, then it is a {{c2::duck}}.

---

You can create any number of such sections in the file.

:warning: This means that you should avoid using the --- syntax anywhere else in the file for inka2 to work correctly. There are exceptions, and you can read about them in documentation.

Inside the section, you can specify the name of the deck to which the cards will be added, and tags for the cards. If deck name isn't specified, then the one from the config is used (Default by default). The deck name is written after Deck:, and tags for all cards after Tags: with spaces between each tag.

Two types of notes are supported:

  • Front/Back: every question starts with number followed by period (e.g. 1., 2. - Markdown ordered list syntax) and every line of the answer starts with > (Markdown quote syntax). Question and answer can span multiple lines.
  • Cloze: same as Front/Back notes, Cloze notes start with number followed by period (Markdown ordered list syntax). inka2 supports three versions of syntax for cloze deletions:
    • Anki syntax: {{c1::hidden text}}
    • Short explicit syntax: {1::hidden text} or {c1::hidden text}
    • Short implicit syntax: {hidden text}

More info and examples on the creating cards documentation page.

Adding Cards to Anki

inka2 will create custom note types for Front/Back and Cloze notes. If you want to use different ones, you can change note types in the config.

Add cards from the file:

inka2 collect path/to/cards.md

Or from all Markdown files in a directory:

inka2 collect path/to/directory

You can also pass multiple paths at once:

inka2 collect path/to/cards.md path/to/folder

You can find more information on the documentation page.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

inka2-2.4.0.tar.gz (52.9 kB view hashes)

Uploaded Source

Built Distribution

inka2-2.4.0-py3-none-any.whl (41.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page