Anki add-on: Zettel Join

Join/Import your ZettelKästen (or just a dozen of MD files as it be) into Anki Notes. Link to add-on IMPORTANT : This Addon is still under development. While likely compatible with earlier versions, add-on v0.1.0-beta and the uppers have only been extensively tested with Anki ⁨23.12.1 . Features Join MD notes to 'Cloze (treacable)' model support math block, code block, table, image and emoji Zettelkasten, what it is? Zettelkasten is a German word that loosely translates to "note box" or "slip box". Zettels means "Index cards" and Kasten means A box or crate. It is also the name of a note-taking technique that involves writing one idea per note, and storing it in one place, such as a box. The method was popularized by German sociologist Niklas Luhmann , who used it to collect and organize all his research notes in boxes. Read the official introduction to learn more about it. This addon encourage you to recognize your notes system as a Zettlekasten, aimed to your 12 Favorite Problems , not a so-called knowledge base that stored everything. Don't bother though. For now, you can just think of it as a folder containing a dozen of MD files. How to use Prepare your Zettelkasten file system The file system of your ZK is supposed to built as the follow structure: Slipbox-root-folder │ ├─.root ├─ProjectA │ ├─BookX │ │ Chapter01[cloze].md │ │ Chapter02[cloze].md │ │ │ └─BookY │ (...) │ └─ProjectB (...) Most importantly, include a '.root' folder in your Kästen's root, this will indicate this folder is a Knowledge Base. Hidden files and folders starts with . will be ignored. Folder name will be joined together as deck's name such as: ProjectA::BookX Add suffix like [cloze] to the end of filename, which indicates what Note-type it uses. For more information, see next section. FileSuffix and NoteType The "FileSuffix" indicates which NoteType(Model) should your MD note map to. The addon will create NoteTypes after the profile loaded. And it will recognize if the MD file has valid "FileSuffix" then import it. | [FileSuffix] | NoteType | | ------------ | ----------------- | | [cloze] | Cloze (traceable) | Unfortunately, AnkiWeb doesn't support markdown table. Look at the examples to learn about how to write a MD file. One-click import When the add-on is downloaded, a KBjoin option will be added to the Tools menu. Click it and choose your Knowledge Base Location, and that's all. Changelog This Addon is still under development. Version hasn't been setup yet v0.1.0-beta -- 2024-04-20 What's Changed Join MD notes to 'Cloze (treacable)' model support math block, code block, table, image and emoji Full Changelog Help And Support Please do not use reviews for bug reports or support requests. I don't get notified of your reviews, and properly troubleshooting an issue through them is nearly impossible. Instead, please either use the issue tracker (preferred), add-on support forums , or just message me at feathered.hwang@hotmail.com. Constructive feedback and suggestions are always welcome! Credit And License Copyright © 2024 Feathered Hwang Licensed under the GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 . This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. For more information on the license please see the LICENSE file accompanying this add-on. The source code is available on GitHub . Pull requests and other contributions are welcome! Support My Work If you like zettel-join, please give it a :thumbsup: thumbs up and share it with your friends, so that more people can enjoy it!

GitHub repository: featheredhwang/zettel-join
Repository description: Join/Import your ZettelKästen (or just a dozen of MD files as it be) into Anki Notes.
Languages: Python, CSS, HTML
Topics: anki-addon