markdown2anki


Namemarkdown2anki JSON
Version 0.2.0 PyPI version JSON
download
home_page
SummaryA CLI tool and an apkg template to allow you to create flashcards from markdown and have a better experience while using anki for your studies. 🌸
upload_time2023-04-19 18:34:14
maintainer
docs_urlNone
author
requires_python>=3.10
licenseCopyright (C) 2023, Alex Biosa (mochitto), mochittodeveloper@gmail.com This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>. ----------------------------------------------------------------------------- Mistune Copyright (c) 2014, Hsiaoming Yang All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the creator nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ----------------------------------------------------------------------------- Pygments Copyright (c) 2006-2022 by the respective authors (see PYGMENTS_AUTHORS file). All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
keywords anki flashcard markdown apkg cli
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Markdown2Anki
Markdown2Anki is a Python script that allows you to easily format your cards using Markdown syntax, and then import them into Anki while retaining the structure you gave them.  
This tool supports code highlighting, clozes, and images, making it a versatile and convenient option for anyone looking to streamline their flashcard creation process.
Additionally, it offers support for Obsidian notes, allowing you to create links inside your cards that point to your vault's notes! 🌸

---
![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Main-demo_1.webp) 
> Unleash the power of spaced repetition: Convert your Markdown notes into Anki flashcards for optimal learning.  
`ChatGPT, when asked for a captivating description of this project.`

---
## Table of contents (for GitHub)
- [Features](#features)
  - [Technical features](#technical-features)
  - [Images](#images)
- [Installation](#installation)
  - [Initial setup](#initial-setup)
  - [Using fill the blanks](#using-fill-the-blanks)
- [Usage](#usage)
  - [Markdown formatting](#markdown-input-formatting)
  - [Importing cards](#importing-your-cards)
  - [Importing images](#importing-your-images)
  - [Errors and Bad cards](#errors-and-bad-cards)
  - [Using clozes](#using-clozes)
  - [Changing themes](#changing-themes)
  - [Navigating the UI](#navigating-the-ui)
- ["Can't find any element..." query Error](#query_error)
- [Creating a custom theme](#creating-a-new-theme)
- [Contributing and dev documentation](#contributing-and-dev-documentation)
- [The reasons behind the project](#the-reasons-behind-the-project)
- [Technologies used](#technologies-used)
- [Hopes for the future](#hopes-for-the-future)
- [Versioning](#versioning)
- [License](#license)
- [Closing note](#closing-note)

---
This is an open-source free software, you can find it on:  
Github - https://github.com/Mochitto/Markdown2Anki  
PyPi - https://pypi.org/project/markdown2anki

---

## Features
- **Write and format cards in Markdown**: create cards in Markdown syntax and then import them into Anki while retaining their structure.
- **Custom Note types** that support split-screen, tabs, keyboard shortcuts, and mobile devices.
- **No addons needed**: The resulting cards are pure HTML and the note-type is CSS and JS, which work with vanilla Anki.
- **Different themes**: themes for both day and night modes, which are easily customizable. You can [check them out here](https://github.com/Mochitto/Markdown2Anki/tree/master/themes)!
- **Code highlighting** (using [pygments](https://pygments.org/)).
- **Support for clozes** including those in code blocks.
- **Support for images** with automatic importing: the program can find the images you mention in your obsidian notes and copy them to your Anki's media folder.
- **Support for Obsidian links and images**: using `[[Note.md|my Note]]` and `[[my_image.jpg]]`-like markdown.
- **Accessible config file** that can self-heal (using [Type-Config](https://pypi.org/project/type-config/)): retaining as many custom configurations as possible even if the file is corrupted. This also ensures that if options are added with updates, your custom configuration will be retained.
- **Helpful error messages and feedback**.
- **Backup files of your inputs**, to help you retry in case something goes wrong.
- **Funny and expressive emoji in the CLI** to make the tool more engaging and enjoyable to use.
### Technical features
- **Extensive python tests coverage**: as of 2023-03-13, there are 108 tests for this tool to ensure its robustness and reliability.
- **Modular structure** to facilitate maintainability and contributions.
- **Os agnostic**: this tool can run on any operating system.
- **Type-safe python and javascript**.
- **Type-safe user configuration**: user configurations are validated and type-casted upon file-reading to ensure their accuracy and consistency.
- **SMACSS methodology driven SASS/CSS, with BEM classes nomenclature**: for organized and structured styling.
- **Minified and bundled JS/CSS** including themes, for efficient and fast performance in the "production" note type.
- **Mobile first responsive CSS**: to ensure it's fully responsive on all devices.
- **High-level dev documentation** to make it easier for contributions and maintenance.

## Images

### CLI
![Demo image of the CLI](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Terminal-demo.webp)  
[Video demo of the CLI](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/CLI_demo.mp4)
### Split-screen
![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-split-screen.webp) 
### Code highlighting
![Demo code highlighting](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo_highlight.gif)
### Clozes support
![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-cloze-standard.webp) 
![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-cloze-answer.webp) 
### Supports the addon "fill the blanks"
![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Usage_demo1.webp)
### Mobile (with light mode)
Mobile version | Clozes in mobile
:---: | :---:
![Demo image of mobile](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/mobile_demo.webp) | ![Demo image of mobile](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/mobile_cloze_demo.webp)

## Installation

This project is distributed using `pip` via [Pypi](https://pypi.org/).
This means you need Python installed on your machine, you can get it here: https://www.python.org/downloads/  
**IMPORTANT!**: When installing, make sure to check the `Add python to PATH` if on Windows/Mac.

Once you have installed Python, you can write in the command line:
```bash
python -m pip install Markdown2Anki
```
And then you should be able to run:
```bash
md2anki
```
There is a guided setup on your first time running the app, which will help you get up and running :)  


**Notice:** This app uses emoji to give instant feedback to the user, depending on your terminal you might not be able to see them correctly.  
On windows you can use the [Windows terminal](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701). 
On iOS and Linux they should be supported by default.

You can also get all of the possible arguments for the script with:
```bash
md2anki -h
```

The script will also let you know when there is a new update and point you to the [CHANGELOG.md](https://github.com/Mochitto/Markdown2Anki/blob/master/CHANGELOG.md) file, where you can read what has changed and decide if to update or not.  
![Update demo](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-update.webp)
You can update the package with:
```bash
python -m pip install --upgrade Markdown2Anki
```
After doing this, the app will ask you again the location of your program folder and update (or heal) your configuration if it is present; if not, it will create a new one.

### Initial setup
During the initial setup process, you will be prompted to select a folder where the program will put its files.  
Once you will have confirmed the path to said folder, a configuration file named `md2anki.config.ini` will be added to it.  
The configuration file holds all the information on each option, what it does and if it's required or not.

**Suggested:** Among the options, you might want to set as `images out-folder` your Anki media folder; this option sets the folder where images are copied to when they are found in your notes; by setting it to your anki's media folder, images are automatically added to you Anki's database.  
You can learn more about Anki's folders here: https://docs.ankiweb.net/files.html#file-locations

There will also be a `markdown2anki.apkg` file which contains the anki note types you will need when importing the cards.  
If you have Anki installed on your system, you should be able to just double-click the file to import it, and it will create a new deck with some template cards and the note types.  
You can learn more on `.apkg` files here: https://docs.ankiweb.net/exporting.html#deck-apkg

### Using fill the blanks

If you would like to have "type-in" clozes, you can use this addon: [fill the blanks addon](https://ankiweb.net/shared/info/1933645497).  
For it to work, you will need to duplicate the `Markdown2Anki - Cloze` Note type and modify it by changing the `Front side` field to: `{{type:cloze:Front}}`.  

This is a video with how you can achieve this: [Video Tutorial on how to modify a note type](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/How_to_make_type_in_cloze.mp4)

![Demo of fill the blanks](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-cloze-addon.webp)

## Usage

### Markdown input formatting
To ensure that your notes are properly recognized by the program, there are a few formatting requirements:

#### Cards separator
Cards must be separated by a horizontal rule using three dashes or more `---`.  
**Notice:** `***` do not work as cards separators, this is so that you can use `*` to define horizontal rules inside of your cards :)

#### Tabs
A unique feature of this program is the ability to create tabs within your cards.  
Tabs are divided depending on the card side (front, back) and the tabs side (left window, right window).  

Front side tabs, unless removed with the `-` flag (more on this later), are retained when moving to the back side (aka. "flipping the card").  
Back side tabs are added after the front tabs, unless they replace one that has been removed.

#### Tab Labels and flags
Tab labels define the beginning of a tab and its content, and should be formatted as follows:
```
## <flags> [<tab label>]
```

Flags define where your tab goes (left or right side of the card, front or back side of the card).  

The possible flags are:
Flags | Meaning 
 --- | --- 
`F` | Front side of the card
`B` | Back side of the card 
`L` | Left tabs side
`R` | Right tabs side
`-` | Only applied to Front tabs: removes the tab when switching to the back side
`+` | Only applied to Back tabs: replaces a removed front tab 

```markdown
## BR [This is my tab]
And this is its body
```
**Notice:** Tab labels do not support Markdown formatting, such as bold text etc.

**Default values**:  
`F`ront and `L`eft flags are applied automatically, so you can leave them out.
```markdown
## [My tab]
is the same as
## FL [My tab]

## B [My tab]
is the same as 
## BL [My tab]

## R [My tab]
is the same as
## FR [My tab]
```

#### Example
Here are two example cards to illustrate the formatting requirements:
```markdown
## - [Question]
# A great addition to humanity
What is the **name** of this funny cat?
## Make sure you get it right.

## R [Funny cat]
![[bingus.png]]

## +B [Answer]
This is the magnificent Bingus.

---

## [Complete the code]
This is the code needed to reverse sort a list.
```python
my_list = [3,5,2]
# New list
sorted_list = {{C1::sorted}}(my_list, {{C1::True}})
# In place
my_list.{{C1::sort}}(True)
    ```

```
The result:
![Usage demo image 2](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Usage_demo2.webp)
![Usage demo image 3](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Usage_demo3.webp)
(This is using the [fill the blanks addon](https://ankiweb.net/shared/info/1933645497))
![Usage demo image 1](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Usage_demo1.webp)

### Importing your cards
Once you have processed your cards, they will be divided in cards with clozes and cards without clozes.  
Those will become two `.csv` files: `basic_anki_cards.csv` and `clozed_anki_cards.csv`.  
To import these, you have to open up Anki and press the "Import File" in the lower side of the main menu, or, if you prefer, you can use "File>Import" from the menu in the top-left of the Anki app.  
After selecting the `.csv` file, you have to let anki know that the separator used is `Comma`, select the right `note type` and the deck you wish the cards to be imported in.
Also make sure to allow HTML in the cards, as they need it to work correctly.

This is a screenshot of how this could look in your Anki (Anki's UI can change depending on the OS it is running on):  
![Image of Anki's import screen](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Anki_import_example.webp)

You can find more information on importing to Anki here: https://docs.ankiweb.net/importing.html

### Importing your images
You can import images automatically if you add the path to your [Anki media folder](https://docs.ankiweb.net/files.html#file-locations) in the config file.  
Images that are already present won't be added twice and will be skipped (based on filename).  
If you prefer checking the images before importing them manually, you can point to another folder or leave the default one.   
**Notice:** when images are copied, they lose their metadata: this is due to security, as others' could read your images metadata if you were to share your cards, and for how the python library that handles the copying process is implemented.

Hopefully, in the near future, the importing part will be made automatic by the addition of `AnkiConnect` support.

### Errors and Bad cards
When there are errors in formatting, the app will let you know what went wrong and create a `Bad_cards.md` file in your program folder.  
This will be a file of all of the "Bad cards" (cards that had a problem in them). The specific error for each card is added before the tabs, so that you can easily fix them.

These, as other text added at the beginning of a card, before all the tabs labels, are considered comments, so you can leave them in.  
For example:
```markdown
❌ ERROR ❌ - A card without front tabs has been found.
## B [My card]
That is very cool ⭐

---

❌ ERROR ❌ - A tab without body has been found.
## [Fast inverse square root]
```

Some common card errors are:
- Forgetting the body of a tab
- Leaving the front-side of a card empty
- Removing a tab that contains a cloze in it  

Some common general errors are:
- The configuration file is missing a necessary option (such as your `vault's name`)
- No cards were found in the input file


Once you have fixed your bad cards, you can run the program with 
```
md2anki -bf
```
This will automatically use the `Bad_cards.md` as input, if you prefer fixing the cards in that file instead of adding them to the main input file.

A `debug_log.txt` file is also present in your program folder, which is created every time you run the program. This file contains more information on what happens when the program is running, the result of various processes, your configuration and so on.  
If you find a bug in the program, it would be of great help if you could add this file to your issues on GitHub.  

**Privacy Notice:** the log file has your configuration in it, as it can contain crucial information for debugging.  
If you don't want to share your paths or other information from it when making issues, you should search-and-replace that information with some fake one, while trying not to change their general structure.

### Using clozes
You can specify clozes in your markdown and they will be carried over to your anki cards. Whenever there is a word or sentence you'd like to have as a cloze, you can use Anki's formatting `{{c<number>::<word>::<hint?>}}` (notice the two colons, not just one).
Clozes will also work in code blocks.

The number tells Anki what cloze to add to what card. This means that if you have C1, C2 and C3, there will be three cards created (this is a feature of Anki, not of Markdown2Anki), each missing the respective words.  
More on this here: https://docs.ankiweb.net/editing.html#cloze-deletion

For example:
```python
my_list = [3,5,2]
# New list
sorted_list = {{C1::sorted}}(my_list, {{C1::True}}) 
# In place
my_list.{{C1::sort}}(True)
```
Result
Notice how all instances of `sort` and `True` are turned into clozes, even if only specified once in the Markdown text.
![Demo of clozes](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/cloze_example.webp)

### Changing Themes
The default theme is mochitto's Rosé Pine theme, but there is also a catpuccin theme.  
You can find all the themes in the [themes folder](https://github.com/Mochitto/Markdown2Anki/tree/master/themes).  
To use another theme, you can just copy the CSS from the file in the themes folder and paste it in your Note types' styling field.  

This can be found by accessing `Tools>Manage Note Types>(select your note type)>Cards(on the right)>Styling(on the left)`. The `Tools` menu is found in the top-left part of Anki's main menu.   
You can reference this: [Video Tutorial showing how to access a card's style](https://github.com/Mochitto/Markdown2Anki/blob/master/docs/How_to_find_styling.mp4)

You can read more on how styling happens here: https://docs.ankiweb.net/templates/styling.html

### Navigating the UI
The custom User Interface of the note-type that comes with this project is focused on the concept of tabs.  
You can have side-by-side tabs and multiple tabs to toggle through.  

![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Main-demo_1.webp)

To navigate them, you can either click on the labels of non-active tabs to make them active (switch to them), and click an active tab to make it full-screen.  
This works also in mobile. 

There are also keyboard commands: you can select a tab with `<alt>+<number of the tab>` or `⌥  + <number of the tab>` (the number is displayed next to the tab label) to switch to that tab or make it full-screen, or you can `TAB` between to navigate between them.  

For example, `Alt+1` will show the first tab if it's not-active, or make it full-screen if it's active.

**Notice**: at times the hotkeys don't seem to work completely (maybe one tab is not accessible with `<alt>`); I'm working on understanding better how Anki handles HTML and Javascript, as it's a problem on how it handles changing between cards... The `<tab>` and `<click>` methods seem to be stable, so you can use those if this bug happens.  
I'm sorry about it...

## Query error
Sometimes, you might come across a screen saying "ERROR: Couldn't find any element using the query [...]".  
This happens because, for some reason, Anki is not loading correctly the card or the script. This shouldn't happen often and I'm still trying to understand better the underlying reasons behind it, as they have to do with Anki's way of handling HTML and Javascript...  
It will likely be patched in the near future, until then, your best call is to go back to the main menu and try again, or restarting Anki; this often fixes the problem.  
I'm sorry about it...

## Creating a new theme
The theme was made with customizability in mind; you can learn more on how to make your own theme in the [theme builder folder's README](https://github.com/Mochitto/Markdown2Anki/tree/master/theme_builder).  
Once you've made your own theme, you can submit it as a contribution to make it "official" and share it with others.

## Contributing and dev documentation
The project was built with contributions and future projects in mind, using expressive names, doc strings on functions/classes/modules and types.  
You can read more on the project's inner workings in the [CONTRIBUTING.md](https://github.com/Mochitto/Markdown2Anki/blob/master/CONTRIBUTING.md).  
If you want to help with issues, you can head to [this project's kanban](https://github.com/users/Mochitto/projects/3).

If you have any questions or find something in the documentation that is not clear, let me know with an issue, I'll (mochitto) will get back to you asap!

## The reasons behind the project
Anki uses formatted text and html, but makes users pick a very strict way of defining that, while using plain text.
This "helps" some users by shielding them from the possible complexity of formatting the text, but a lot more could be achieved by giving them freedom with Markdown.  

Markdown formatting also makes space for coding cards, which are pretty awful to make in Anki (even if, thanks to [Ijgnd](https://ankiweb.net/shared/info/1100811177) and [Glutanimate](https://ankiweb.net/shared/info/1463041493), there was at least an ok possibility to make them work).  
This means that users do not really need tens of note types, but can define the kind of note they actually need while writing them (or by using their own, flexible templates).  
This also takes away some limitations, such as having to use clozes on only one field of the card.

I (mochitto) also really like the idea of Open Source/Free software communicating between different projects, so creating a "bridge" between Obsidian and Anki feels like a great way of pulling together applications that give society a huge value, making them even stronger.

## Technologies used
### Languages
- [Typescript](https://www.typescriptlang.org/)
- [Sass](https://sass-lang.com/)
- [Python](https://www.python.org/)
### Building
- [Esbuild](https://esbuild.github.io/)
- [Esbuild sass plugin](https://www.npmjs.com/package/esbuild-sass-plugin)
- [Live server](https://www.npmjs.com/package/live-server) 
### Core dependencies
- Markdown to HTML parser and compiler: [Mistune](https://mistune.lepture.com/en/latest/)
- Code highlighter: [Pygments](https://pygments.org/)
### Testing
- [Pytest](https://docs.pytest.org/en/7.2.x/)
### Methodology
- Mobile-first approach
- [BEM nomenclature](https://getbem.com/)
- [Scalable and Modular Architecture for CSS](http://smacss.com/)
- Test Driven Development

## Hopes for the future
Some things that I hope will be implemented in the future, either by me (mochitto) or by the community are:
- [ ] A colorblind-friendly theme
- [ ] An high-contrast theme
- [ ] Any other accessibility improvement
- [ ] Support for more advanced formatting Markdown options
- [ ] [AnkiConnect](https://foosoft.net/projects/anki-connect/) support to make imports automatic
- [ ] An Obsidian addon to run the script/setup the configs from Obsidian
- [ ] Someone making a video about Markdown2Anki, either to just share it or a guide on how it works and how to install it
- [ ] A comprehensive documentation

## Versioning
The formatting of the changelog file is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
You can [read the CHANGELOG file here](https://github.com/Mochitto/Markdown2Anki/blob/master/CHANGELOG.md).

## License
This project uses the [GPL3 LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt).  
The project was made possible by lots of free software and is a bridge between free softwares; it couldn't have been made possible without [Pygments](https://pygments.org/), [Mistune](https://mistune.lepture.com/en/latest/), [Pytest](https://docs.pytest.org/en/7.2.x/), [esbuild](https://esbuild.github.io/), [sass](https://sass-lang.com/) and tons more of community efforts. 

### Closing note
I hope this project inspires others to create more open source software, fostering growth and collaboration within our community and society.  - Mochitto, 2023

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "markdown2anki",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "",
    "keywords": "anki,flashcard,markdown,apkg,cli",
    "author": "",
    "author_email": "\"Alex Biosa (mochitto)\" <mochittodeveloper@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/c6/d4/f4b15bb88ac62229391e574ad4a83a96f6c01c78641e247aaef07bc3ef33/markdown2anki-0.2.0.tar.gz",
    "platform": null,
    "description": "# Markdown2Anki\nMarkdown2Anki is a Python script that allows you to easily format your cards using Markdown syntax, and then import them into Anki while retaining the structure you gave them.  \nThis tool supports code highlighting, clozes, and images, making it a versatile and convenient option for anyone looking to streamline their flashcard creation process.\nAdditionally, it offers support for Obsidian notes, allowing you to create links inside your cards that point to your vault's notes! \ud83c\udf38\n\n---\n![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Main-demo_1.webp) \n> Unleash the power of spaced repetition: Convert your Markdown notes into Anki flashcards for optimal learning.  \n`ChatGPT, when asked for a captivating description of this project.`\n\n---\n## Table of contents (for GitHub)\n- [Features](#features)\n  - [Technical features](#technical-features)\n  - [Images](#images)\n- [Installation](#installation)\n  - [Initial setup](#initial-setup)\n  - [Using fill the blanks](#using-fill-the-blanks)\n- [Usage](#usage)\n  - [Markdown formatting](#markdown-input-formatting)\n  - [Importing cards](#importing-your-cards)\n  - [Importing images](#importing-your-images)\n  - [Errors and Bad cards](#errors-and-bad-cards)\n  - [Using clozes](#using-clozes)\n  - [Changing themes](#changing-themes)\n  - [Navigating the UI](#navigating-the-ui)\n- [\"Can't find any element...\" query Error](#query_error)\n- [Creating a custom theme](#creating-a-new-theme)\n- [Contributing and dev documentation](#contributing-and-dev-documentation)\n- [The reasons behind the project](#the-reasons-behind-the-project)\n- [Technologies used](#technologies-used)\n- [Hopes for the future](#hopes-for-the-future)\n- [Versioning](#versioning)\n- [License](#license)\n- [Closing note](#closing-note)\n\n---\nThis is an open-source free software, you can find it on:  \nGithub - https://github.com/Mochitto/Markdown2Anki  \nPyPi - https://pypi.org/project/markdown2anki\n\n---\n\n## Features\n- **Write and format cards in Markdown**: create cards in Markdown syntax and then import them into Anki while retaining their structure.\n- **Custom Note types** that support split-screen, tabs, keyboard shortcuts, and mobile devices.\n- **No addons needed**: The resulting cards are pure HTML and the note-type is CSS and JS, which work with vanilla Anki.\n- **Different themes**: themes for both day and night modes, which are easily customizable. You can [check them out here](https://github.com/Mochitto/Markdown2Anki/tree/master/themes)!\n- **Code highlighting** (using [pygments](https://pygments.org/)).\n- **Support for clozes** including those in code blocks.\n- **Support for images** with automatic importing: the program can find the images you mention in your obsidian notes and copy them to your Anki's media folder.\n- **Support for Obsidian links and images**: using `[[Note.md|my Note]]` and `[[my_image.jpg]]`-like markdown.\n- **Accessible config file** that can self-heal (using [Type-Config](https://pypi.org/project/type-config/)): retaining as many custom configurations as possible even if the file is corrupted. This also ensures that if options are added with updates, your custom configuration will be retained.\n- **Helpful error messages and feedback**.\n- **Backup files of your inputs**, to help you retry in case something goes wrong.\n- **Funny and expressive emoji in the CLI** to make the tool more engaging and enjoyable to use.\n### Technical features\n- **Extensive python tests coverage**: as of 2023-03-13, there are 108 tests for this tool to ensure its robustness and reliability.\n- **Modular structure** to facilitate maintainability and contributions.\n- **Os agnostic**: this tool can run on any operating system.\n- **Type-safe python and javascript**.\n- **Type-safe user configuration**: user configurations are validated and type-casted upon file-reading to ensure their accuracy and consistency.\n- **SMACSS methodology driven SASS/CSS, with BEM classes nomenclature**: for organized and structured styling.\n- **Minified and bundled JS/CSS** including themes, for efficient and fast performance in the \"production\" note type.\n- **Mobile first responsive CSS**: to ensure it's fully responsive on all devices.\n- **High-level dev documentation** to make it easier for contributions and maintenance.\n\n## Images\n\n### CLI\n![Demo image of the CLI](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Terminal-demo.webp)  \n[Video demo of the CLI](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/CLI_demo.mp4)\n### Split-screen\n![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-split-screen.webp) \n### Code highlighting\n![Demo code highlighting](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo_highlight.gif)\n### Clozes support\n![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-cloze-standard.webp) \n![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-cloze-answer.webp) \n### Supports the addon \"fill the blanks\"\n![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Usage_demo1.webp)\n### Mobile (with light mode)\nMobile version | Clozes in mobile\n:---: | :---:\n![Demo image of mobile](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/mobile_demo.webp) | ![Demo image of mobile](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/mobile_cloze_demo.webp)\n\n## Installation\n\nThis project is distributed using `pip` via [Pypi](https://pypi.org/).\nThis means you need Python installed on your machine, you can get it here: https://www.python.org/downloads/  \n**IMPORTANT!**: When installing, make sure to check the `Add python to PATH` if on Windows/Mac.\n\nOnce you have installed Python, you can write in the command line:\n```bash\npython -m pip install Markdown2Anki\n```\nAnd then you should be able to run:\n```bash\nmd2anki\n```\nThere is a guided setup on your first time running the app, which will help you get up and running :)  \n\n\n**Notice:** This app uses emoji to give instant feedback to the user, depending on your terminal you might not be able to see them correctly.  \nOn windows you can use the [Windows terminal](https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701). \nOn iOS and Linux they should be supported by default.\n\nYou can also get all of the possible arguments for the script with:\n```bash\nmd2anki -h\n```\n\nThe script will also let you know when there is a new update and point you to the [CHANGELOG.md](https://github.com/Mochitto/Markdown2Anki/blob/master/CHANGELOG.md) file, where you can read what has changed and decide if to update or not.  \n![Update demo](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-update.webp)\nYou can update the package with:\n```bash\npython -m pip install --upgrade Markdown2Anki\n```\nAfter doing this, the app will ask you again the location of your program folder and update (or heal) your configuration if it is present; if not, it will create a new one.\n\n### Initial setup\nDuring the initial setup process, you will be prompted to select a folder where the program will put its files.  \nOnce you will have confirmed the path to said folder, a configuration file named `md2anki.config.ini` will be added to it.  \nThe configuration file holds all the information on each option, what it does and if it's required or not.\n\n**Suggested:** Among the options, you might want to set as `images out-folder` your Anki media folder; this option sets the folder where images are copied to when they are found in your notes; by setting it to your anki's media folder, images are automatically added to you Anki's database.  \nYou can learn more about Anki's folders here: https://docs.ankiweb.net/files.html#file-locations\n\nThere will also be a `markdown2anki.apkg` file which contains the anki note types you will need when importing the cards.  \nIf you have Anki installed on your system, you should be able to just double-click the file to import it, and it will create a new deck with some template cards and the note types.  \nYou can learn more on `.apkg` files here: https://docs.ankiweb.net/exporting.html#deck-apkg\n\n### Using fill the blanks\n\nIf you would like to have \"type-in\" clozes, you can use this addon: [fill the blanks addon](https://ankiweb.net/shared/info/1933645497).  \nFor it to work, you will need to duplicate the `Markdown2Anki - Cloze` Note type and modify it by changing the `Front side` field to: `{{type:cloze:Front}}`.  \n\nThis is a video with how you can achieve this: [Video Tutorial on how to modify a note type](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/How_to_make_type_in_cloze.mp4)\n\n![Demo of fill the blanks](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Demo-cloze-addon.webp)\n\n## Usage\n\n### Markdown input formatting\nTo ensure that your notes are properly recognized by the program, there are a few formatting requirements:\n\n#### Cards separator\nCards must be separated by a horizontal rule using three dashes or more `---`.  \n**Notice:** `***` do not work as cards separators, this is so that you can use `*` to define horizontal rules inside of your cards :)\n\n#### Tabs\nA unique feature of this program is the ability to create tabs within your cards.  \nTabs are divided depending on the card side (front, back) and the tabs side (left window, right window).  \n\nFront side tabs, unless removed with the `-` flag (more on this later), are retained when moving to the back side (aka. \"flipping the card\").  \nBack side tabs are added after the front tabs, unless they replace one that has been removed.\n\n#### Tab Labels and flags\nTab labels define the beginning of a tab and its content, and should be formatted as follows:\n```\n## <flags> [<tab label>]\n```\n\nFlags define where your tab goes (left or right side of the card, front or back side of the card).  \n\nThe possible flags are:\nFlags | Meaning \n --- | --- \n`F` | Front side of the card\n`B` | Back side of the card \n`L` | Left tabs side\n`R` | Right tabs side\n`-` | Only applied to Front tabs: removes the tab when switching to the back side\n`+` | Only applied to Back tabs: replaces a removed front tab \n\n```markdown\n## BR [This is my tab]\nAnd this is its body\n```\n**Notice:** Tab labels do not support Markdown formatting, such as bold text etc.\n\n**Default values**:  \n`F`ront and `L`eft flags are applied automatically, so you can leave them out.\n```markdown\n## [My tab]\nis the same as\n## FL [My tab]\n\n## B [My tab]\nis the same as \n## BL [My tab]\n\n## R [My tab]\nis the same as\n## FR [My tab]\n```\n\n#### Example\nHere are two example cards to illustrate the formatting requirements:\n```markdown\n## - [Question]\n# A great addition to humanity\nWhat is the **name** of this funny cat?\n## Make sure you get it right.\n\n## R [Funny cat]\n![[bingus.png]]\n\n## +B [Answer]\nThis is the magnificent Bingus.\n\n---\n\n## [Complete the code]\nThis is the code needed to reverse sort a list.\n```python\nmy_list = [3,5,2]\n# New list\nsorted_list = {{C1::sorted}}(my_list, {{C1::True}})\n# In place\nmy_list.{{C1::sort}}(True)\n    ```\n\n```\nThe result:\n![Usage demo image 2](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Usage_demo2.webp)\n![Usage demo image 3](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Usage_demo3.webp)\n(This is using the [fill the blanks addon](https://ankiweb.net/shared/info/1933645497))\n![Usage demo image 1](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Usage_demo1.webp)\n\n### Importing your cards\nOnce you have processed your cards, they will be divided in cards with clozes and cards without clozes.  \nThose will become two `.csv` files: `basic_anki_cards.csv` and `clozed_anki_cards.csv`.  \nTo import these, you have to open up Anki and press the \"Import File\" in the lower side of the main menu, or, if you prefer, you can use \"File>Import\" from the menu in the top-left of the Anki app.  \nAfter selecting the `.csv` file, you have to let anki know that the separator used is `Comma`, select the right `note type` and the deck you wish the cards to be imported in.\nAlso make sure to allow HTML in the cards, as they need it to work correctly.\n\nThis is a screenshot of how this could look in your Anki (Anki's UI can change depending on the OS it is running on):  \n![Image of Anki's import screen](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Anki_import_example.webp)\n\nYou can find more information on importing to Anki here: https://docs.ankiweb.net/importing.html\n\n### Importing your images\nYou can import images automatically if you add the path to your [Anki media folder](https://docs.ankiweb.net/files.html#file-locations) in the config file.  \nImages that are already present won't be added twice and will be skipped (based on filename).  \nIf you prefer checking the images before importing them manually, you can point to another folder or leave the default one.   \n**Notice:** when images are copied, they lose their metadata: this is due to security, as others' could read your images metadata if you were to share your cards, and for how the python library that handles the copying process is implemented.\n\nHopefully, in the near future, the importing part will be made automatic by the addition of `AnkiConnect` support.\n\n### Errors and Bad cards\nWhen there are errors in formatting, the app will let you know what went wrong and create a `Bad_cards.md` file in your program folder.  \nThis will be a file of all of the \"Bad cards\" (cards that had a problem in them). The specific error for each card is added before the tabs, so that you can easily fix them.\n\nThese, as other text added at the beginning of a card, before all the tabs labels, are considered comments, so you can leave them in.  \nFor example:\n```markdown\n\u274c ERROR \u274c - A card without front tabs has been found.\n## B [My card]\nThat is very cool \u2b50\n\n---\n\n\u274c ERROR \u274c - A tab without body has been found.\n## [Fast inverse square root]\n```\n\nSome common card errors are:\n- Forgetting the body of a tab\n- Leaving the front-side of a card empty\n- Removing a tab that contains a cloze in it  \n\nSome common general errors are:\n- The configuration file is missing a necessary option (such as your `vault's name`)\n- No cards were found in the input file\n\n\nOnce you have fixed your bad cards, you can run the program with \n```\nmd2anki -bf\n```\nThis will automatically use the `Bad_cards.md` as input, if you prefer fixing the cards in that file instead of adding them to the main input file.\n\nA `debug_log.txt` file is also present in your program folder, which is created every time you run the program. This file contains more information on what happens when the program is running, the result of various processes, your configuration and so on.  \nIf you find a bug in the program, it would be of great help if you could add this file to your issues on GitHub.  \n\n**Privacy Notice:** the log file has your configuration in it, as it can contain crucial information for debugging.  \nIf you don't want to share your paths or other information from it when making issues, you should search-and-replace that information with some fake one, while trying not to change their general structure.\n\n### Using clozes\nYou can specify clozes in your markdown and they will be carried over to your anki cards. Whenever there is a word or sentence you'd like to have as a cloze, you can use Anki's formatting `{{c<number>::<word>::<hint?>}}` (notice the two colons, not just one).\nClozes will also work in code blocks.\n\nThe number tells Anki what cloze to add to what card. This means that if you have C1, C2 and C3, there will be three cards created (this is a feature of Anki, not of Markdown2Anki), each missing the respective words.  \nMore on this here: https://docs.ankiweb.net/editing.html#cloze-deletion\n\nFor example:\n```python\nmy_list = [3,5,2]\n# New list\nsorted_list = {{C1::sorted}}(my_list, {{C1::True}}) \n# In place\nmy_list.{{C1::sort}}(True)\n```\nResult\nNotice how all instances of `sort` and `True` are turned into clozes, even if only specified once in the Markdown text.\n![Demo of clozes](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/cloze_example.webp)\n\n### Changing Themes\nThe default theme is mochitto's Ros\u00e9 Pine theme, but there is also a catpuccin theme.  \nYou can find all the themes in the [themes folder](https://github.com/Mochitto/Markdown2Anki/tree/master/themes).  \nTo use another theme, you can just copy the CSS from the file in the themes folder and paste it in your Note types' styling field.  \n\nThis can be found by accessing `Tools>Manage Note Types>(select your note type)>Cards(on the right)>Styling(on the left)`. The `Tools` menu is found in the top-left part of Anki's main menu.   \nYou can reference this: [Video Tutorial showing how to access a card's style](https://github.com/Mochitto/Markdown2Anki/blob/master/docs/How_to_find_styling.mp4)\n\nYou can read more on how styling happens here: https://docs.ankiweb.net/templates/styling.html\n\n### Navigating the UI\nThe custom User Interface of the note-type that comes with this project is focused on the concept of tabs.  \nYou can have side-by-side tabs and multiple tabs to toggle through.  \n\n![Demo image](https://raw.githubusercontent.com/Mochitto/Markdown2Anki/master/docs/Main-demo_1.webp)\n\nTo navigate them, you can either click on the labels of non-active tabs to make them active (switch to them), and click an active tab to make it full-screen.  \nThis works also in mobile. \n\nThere are also keyboard commands: you can select a tab with `<alt>+<number of the tab>` or `\u2325  + <number of the tab>` (the number is displayed next to the tab label) to switch to that tab or make it full-screen, or you can `TAB` between to navigate between them.  \n\nFor example, `Alt+1` will show the first tab if it's not-active, or make it full-screen if it's active.\n\n**Notice**: at times the hotkeys don't seem to work completely (maybe one tab is not accessible with `<alt>`); I'm working on understanding better how Anki handles HTML and Javascript, as it's a problem on how it handles changing between cards... The `<tab>` and `<click>` methods seem to be stable, so you can use those if this bug happens.  \nI'm sorry about it...\n\n## Query error\nSometimes, you might come across a screen saying \"ERROR: Couldn't find any element using the query [...]\".  \nThis happens because, for some reason, Anki is not loading correctly the card or the script. This shouldn't happen often and I'm still trying to understand better the underlying reasons behind it, as they have to do with Anki's way of handling HTML and Javascript...  \nIt will likely be patched in the near future, until then, your best call is to go back to the main menu and try again, or restarting Anki; this often fixes the problem.  \nI'm sorry about it...\n\n## Creating a new theme\nThe theme was made with customizability in mind; you can learn more on how to make your own theme in the [theme builder folder's README](https://github.com/Mochitto/Markdown2Anki/tree/master/theme_builder).  \nOnce you've made your own theme, you can submit it as a contribution to make it \"official\" and share it with others.\n\n## Contributing and dev documentation\nThe project was built with contributions and future projects in mind, using expressive names, doc strings on functions/classes/modules and types.  \nYou can read more on the project's inner workings in the [CONTRIBUTING.md](https://github.com/Mochitto/Markdown2Anki/blob/master/CONTRIBUTING.md).  \nIf you want to help with issues, you can head to [this project's kanban](https://github.com/users/Mochitto/projects/3).\n\nIf you have any questions or find something in the documentation that is not clear, let me know with an issue, I'll (mochitto) will get back to you asap!\n\n## The reasons behind the project\nAnki uses formatted text and html, but makes users pick a very strict way of defining that, while using plain text.\nThis \"helps\" some users by shielding them from the possible complexity of formatting the text, but a lot more could be achieved by giving them freedom with Markdown.  \n\nMarkdown formatting also makes space for coding cards, which are pretty awful to make in Anki (even if, thanks to [Ijgnd](https://ankiweb.net/shared/info/1100811177) and [Glutanimate](https://ankiweb.net/shared/info/1463041493), there was at least an ok possibility to make them work).  \nThis means that users do not really need tens of note types, but can define the kind of note they actually need while writing them (or by using their own, flexible templates).  \nThis also takes away some limitations, such as having to use clozes on only one field of the card.\n\nI (mochitto) also really like the idea of Open Source/Free software communicating between different projects, so creating a \"bridge\" between Obsidian and Anki feels like a great way of pulling together applications that give society a huge value, making them even stronger.\n\n## Technologies used\n### Languages\n- [Typescript](https://www.typescriptlang.org/)\n- [Sass](https://sass-lang.com/)\n- [Python](https://www.python.org/)\n### Building\n- [Esbuild](https://esbuild.github.io/)\n- [Esbuild sass plugin](https://www.npmjs.com/package/esbuild-sass-plugin)\n- [Live server](https://www.npmjs.com/package/live-server) \n### Core dependencies\n- Markdown to HTML parser and compiler: [Mistune](https://mistune.lepture.com/en/latest/)\n- Code highlighter: [Pygments](https://pygments.org/)\n### Testing\n- [Pytest](https://docs.pytest.org/en/7.2.x/)\n### Methodology\n- Mobile-first approach\n- [BEM nomenclature](https://getbem.com/)\n- [Scalable and Modular Architecture for CSS](http://smacss.com/)\n- Test Driven Development\n\n## Hopes for the future\nSome things that I hope will be implemented in the future, either by me (mochitto) or by the community are:\n- [ ] A colorblind-friendly theme\n- [ ] An high-contrast theme\n- [ ] Any other accessibility improvement\n- [ ] Support for more advanced formatting Markdown options\n- [ ] [AnkiConnect](https://foosoft.net/projects/anki-connect/) support to make imports automatic\n- [ ] An Obsidian addon to run the script/setup the configs from Obsidian\n- [ ] Someone making a video about Markdown2Anki, either to just share it or a guide on how it works and how to install it\n- [ ] A comprehensive documentation\n\n## Versioning\nThe formatting of the changelog file is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).\nYou can [read the CHANGELOG file here](https://github.com/Mochitto/Markdown2Anki/blob/master/CHANGELOG.md).\n\n## License\nThis project uses the [GPL3 LICENSE](https://www.gnu.org/licenses/gpl-3.0.txt).  \nThe project was made possible by lots of free software and is a bridge between free softwares; it couldn't have been made possible without [Pygments](https://pygments.org/), [Mistune](https://mistune.lepture.com/en/latest/), [Pytest](https://docs.pytest.org/en/7.2.x/), [esbuild](https://esbuild.github.io/), [sass](https://sass-lang.com/) and tons more of community efforts. \n\n### Closing note\nI hope this project inspires others to create more open source software, fostering growth and collaboration within our community and society.  - Mochitto, 2023\n",
    "bugtrack_url": null,
    "license": "Copyright (C) 2023, Alex Biosa (mochitto), mochittodeveloper@gmail.com  This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.  You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.  -----------------------------------------------------------------------------  Mistune Copyright (c) 2014, Hsiaoming Yang  All rights reserved.  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.  * Neither the name of the creator nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.  -----------------------------------------------------------------------------  Pygments Copyright (c) 2006-2022 by the respective authors (see PYGMENTS_AUTHORS file). All rights reserved.  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ",
    "summary": "A CLI tool and an apkg template to allow you to create flashcards from markdown and have a better experience while using anki for your studies. \ud83c\udf38",
    "version": "0.2.0",
    "split_keywords": [
        "anki",
        "flashcard",
        "markdown",
        "apkg",
        "cli"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d774ab6c8342c404d028ec7cdd4872781e82222c0c49cedcac786d659a34bf57",
                "md5": "fc97e3dcd31c933626415d0ca8c78248",
                "sha256": "a24e9b28bb2e4e7a5a14805d7c1fd0e1e7afb2ee1d6656bc738c9414132a915a"
            },
            "downloads": -1,
            "filename": "markdown2anki-0.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "fc97e3dcd31c933626415d0ca8c78248",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 156731,
            "upload_time": "2023-04-19T18:34:07",
            "upload_time_iso_8601": "2023-04-19T18:34:07.775772Z",
            "url": "https://files.pythonhosted.org/packages/d7/74/ab6c8342c404d028ec7cdd4872781e82222c0c49cedcac786d659a34bf57/markdown2anki-0.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c6d4f4b15bb88ac62229391e574ad4a83a96f6c01c78641e247aaef07bc3ef33",
                "md5": "89655d78f6fcc2e67ac49ac1c9d4294d",
                "sha256": "82ef401af5f038b4dadc017e41e8e436211b2b670eccd00d1c6d0bf711603323"
            },
            "downloads": -1,
            "filename": "markdown2anki-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "89655d78f6fcc2e67ac49ac1c9d4294d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 2607945,
            "upload_time": "2023-04-19T18:34:14",
            "upload_time_iso_8601": "2023-04-19T18:34:14.219460Z",
            "url": "https://files.pythonhosted.org/packages/c6/d4/f4b15bb88ac62229391e574ad4a83a96f6c01c78641e247aaef07bc3ef33/markdown2anki-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-04-19 18:34:14",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "markdown2anki"
}
        
Elapsed time: 0.06926s