Anki add-on: Notatki text notes importer addon for Anki

Create Anki notes using plain text files and Markdown , then import them directly into Anki. This addon is designed for people who love Anki’s spaced repetition system but prefer writing and managing notes in a normal text editor instead of Anki’s built-in editor. It enables a workflow where you: Write notes in a simple human-readable text-based format. Store them in a regular directory. Import them into Anki automatically. This makes it possible to: Use a real editor like Visual Studio Code. Version control your notes with Git. Collaborate with others. Avoid Anki’s proprietary binary deck format. Motivation Anki is an excellent spaced repetition system, but creating and managing notes has several drawbacks: The built-in note editor UI is inconvenient for large-scale note creation. Decks are distributed in a binary .apkg format, which makes: version control difficult collaboration difficult reviewing changes impossible This addon solves those problems by allowing notes to be written in plain text files. How It Works The addon imports notes from a directory containing text files written in a simple human-readable format. Each file contains a list of note records. Each record is written in Markdown, which allows: formatting LaTeX math images The addon: Asks the user to select a directory containing note files. Recursively scans the directory. Parses the note records. Creates or updates Anki notes. Example Note Files File astronomy.note : !type: Basic !deck: Astronomy !front: The first planet from the Sun. !back: Mercury ~~~ !front: The second planet from the Sun. !back: Venus ~~~ !front: The largest planet in the Solar System. !back: Jupiter ~~~ File geography.note : !type: Cloze !deck: Geography !tags: Capitals !text: The capital of {{c1::Mongolia::country}} is {{c2::Ulaanbaatar::city}}. ~~~ !text: The capital of {{c1::Syria::country}} is {{c2::Damascus::city}}. ~~~ File math.note : !type: Basic !deck: Math !tags: Algebra !front: Quadratic Formula !back: $$ x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$ ~~~ !front: Euler's Formula !back: $$ \begin{align*} e^{ix} &= \cos x + i \sin x \\ e^{-ix} &= \cos x - i \sin x \end{align*} $$ ~~~ Workflow Typical workflow: Write notes in your editor. notes/ calculus.note algebra.note trigonometry.note Version control them. git add notes git commit Import into Anki using the addon. File → Import Notatki... Select the directory with your notes. The addon will parse and import everything. Maybe share your notes with others. Let them collaborate and contribute new notes. Visual Studio Code Extension To make writing notes easier, a companion VS Code extension is available. The extension provides: syntax highlighting for note files auto-completion structural validation note preview on the side This makes writing Anki notes feel like writing documentation.

GitHub repository: aradzie/notatki
Repository description: A collection of tools designed for simple and collaborative Anki note creation.
Languages: TypeScript, JavaScript, Python, PEG.js, CSS, Shell
Topics: anki, anki-flashcards