Home

Awesome

License Release GitHub Repo stars

Anki programming flashcards

Learning to code with Anki: themes, templates, and syntax highlighting for beginners and pros.

<img width="100%" height="auto" src="./source/media/preview-30-08-24.png" style="padding-bottom: 20px;">

Want to learn how to code? πŸ‘¨πŸ»β€πŸ’»πŸ‘©πŸ»β€πŸ’»

Anki helps you learn and remember quickly. You'll know how to code in no time!

The Anki app is a great way to learn, revise, and practice your coding skills, but Anki's default cards aren't great for programming. We can do better! These handy flashcards (and CSS themes) help make it fun to learn.

Are you looking to master html, css, javascript, php, python, lisp, elm, R, SQL β€” or just getting started? If you're new to Anki, read these guides first; otherwise ... let's begin!

Quick start

If you're updating from a previous version, go here. You can merge notetypes, but be safe and backup!

  1. Get the latest Anki deck (.apkg)
  2. Open the Anki desktop app.
  3. File > Import ... the deck,
  4. Add a new card,
  5. Select the APF type (Anki Programming Flashcards),
  6. Get creative with your cards!

Cards

There's two types of cards to choose from:

  1. πŸ’‘ Simple
    • What's the answer?
    • What does this syntax do?
  2. πŸ”Ž Missing!
    • A question with a […] word
    • A question with a [missing] word
  3. πŸ–οΈ Draw! (experimental)1
    • A diagram of a small program you have to guess
    • A sketch of a function or program to drill yourself on

Next, you'll probably want to add some pretty colors to your code. But first, a quick tip on how to keep your Anki deck nice and organised ...

Add color to your code

Syntax highlighting

🎨 Life is better in full colour!

They say code is an art form. Anki flashcard's CSS themes come with a light and dark colour palette; it's also good for dark mode if that's your thing.

You can highlight any code string with basic highlighting, or go full colour with Markdown and Pandoc. Our Breeze Dark theme is a modified version (not the one Pandoc uses).2

Keep it simple, stupid!

☝️ One idea per card. Just one.

Simple is better. If you only had 280 characters, what would you say? It's good practice to write your flashcards like you'd write code β€” as clear as possible. Those 10 cards you wrote with 100 related ideas? Sifting through those will become a chore; 100 cards with one idea is much better!

Imagine you're stupid, writing for your stupid future self; you'll look back on your flashcards and they'll make perfect sense.

A card stuffed with facts will overload the brain. I imagine you're trying to learn:

That's great! But. Keep your questions clear β€” perhaps split a hard question into three easy cardsΒ β€” if you're spending more than a minute reviewing each card; reduce, reduce, reduce. Simplify it!

It's more fun with a compiler (advanced)

When you've levelled up your programming skills, it's time to πŸ§‘β€πŸŽ“ do things the professional way!

<details> <summary><strong>πŸŽ₯ Step 1. Write your flashcards quickly and easily (<code>markdown->html</code>)</strong></summary>&nbsp;

Once you've got the basics of Anki flashcards down, it's time to get fancy with the offline markdown->html compiler. It'll render all your card's data fields for you in a flash!

https://github.com/user-attachments/assets/99a87801-4a4a-488c-9666-613280f6d0b5

</details> <details> <summary><strong>πŸŽ₯ Step 2. Create your own colour theme</strong></summary>&nbsp;

If you're feeling creative, you can also take your code to the next level by πŸ§‘β€πŸŽ¨ creating your own colour theme, with any syntax highlighting pallette you like for your code blocks. You can also change the Typography to your favourite --font!

https://github.com/user-attachments/assets/4769a61f-0843-41d6-a3a3-6f3c93a2d8e7

</details>

I'd advise beginners to start by writing great cards, before moving on to use the compiler. I know when I was starting out using terminal and compilers took some getting used to!

Why Anki flashcards instead of an add-on?

I've spent a lot of time so you can:

The flashcards work on all platforms: AnkiMobile, MacOS (Intel, Silicon) and Android. It depends on very little from the Anki app, no add-ons required (which tend to go out-of-date); it's stable software, with very light dependencies (Node and Pandoc) and a very simple setup.

Dependency hell

πŸ•°οΈ A tool or a piece of software that's still around in 5 years, without any serious changes, is a good thing

There are other plugins out there that are fun to use, but beware of dependency hell!

⚠️ FAQs

<details> <summary> <strong>1. How do I upgrade?</strong> (semantic versioning) </summary>

Always backup your deck before installing a new version! I try to stick to major.minor.patch semantic versioning, so updates don't break existing cards. Anki makes this tricky, so view commits for any major changes to the theme. You can merge your old cards with the new ones.

</details> <details> <summary> <strong>2. How do I write the flashcards?</strong> </summary>

Keep it simple and avoid javascript. Stick to Common Markdown or safe HTML to avoid unintended consequences in Anki. Here's some helpful guides on how to use the Anki software.

</details> <details> <summary> <strong>3. I can't swipe left</strong> to view code on Anki Mobile </summary>

The Anki Mobile app defaults to launching the menu with the swipe left gesture. This is not desirable, as often our code will have an overflow which we want to scroll horizontally. You can change the settings, see issue #118 for a fix.

</details> <details> <summary> <strong>4. I'm having text formatting problems</strong>, what do I do? </summary>&nbsp;

Paste raw html or plain text to avoid styling issues.

If you're having formatting problems, make sure you're following the guide and clicking Toggle HTML Editor βŒ˜β‡§X (β€Ήβ€Ί) in the editor to copy/paste your HTML or raw text. For more information, see this issue. Many editors break formatting when you copy->paste text, or add junk to the html. TL;DR paste as plain text to avoid formatting issues.

</details>

License and inspiration

Anki flashcards are licensed under the MIT Open Source License

Thanks to Ben Frain for Enduring CSS and Jeff Escalante for GPS, I've borrowed ideas from both for sane stylesheets. Anki flashcards are based on Print First, in turn inspired by @cbracco (Cardinal CSS) and Material Design. Pick @mdo or Google's code guide for orderly code.3 iPhone photo by @svstudioart on Freepik.

Footnotes

  1. Meaning, likely to change. I'm trying a few things out privately and when I have something to share, I'll let you know! ↩

  2. This is based on the modified Breeze Dark theme for Visual Studio Code by Andrew Fridley. If you'd prefer the original Pandoc version, you can follow the instructions here. ↩

  3. I don't follow these religiously but it's good to have something to aim for. Hopefully my code isn't too sloppy! ↩