VocabWeave turns plain Obsidian notes into Anki flashcards. You keep one clean note per word, with a heading for each field. VocabWeave maps those headings onto your Anki note type and keeps both sides in sync. If you want, an AI provider of your choice can fill in definitions and example sentences, and draw a picture for the card.

Why VocabWeave

• One source of truth. Your vocabulary lives in your vault as readable Markdown, not locked inside Anki.
• Works with your existing Anki setup. Any deck, any note type, any field names. Nothing is hardcoded.
• AI is optional and yours to choose. Cloud or fully local, bring your own key, and review every result before it's written.
• Your vault stays clean. Generated images go straight into Anki's media folder, never into your vault.

Features

🔄 Sync

• Dynamic field mapping. Each ## Heading in the note fills the Anki field of the same name, and common aliases also work (for example ## Word → Front).
• Sync, rebuild, or delete the active note from the sidebar in one click.
• Two-way awareness. If you edited the card in Anki, VocabWeave notices on the next sync and asks which version to keep instead of silently overwriting it.
• Auto sync on save (off by default) for notes that already have a deck and model.
• The note name follows the main field, so your file list reads like a word list.

✍️ Create

• Profiles bundle a deck, a note type, and a save folder, so switching languages is one dropdown.
• Create new note gives you an empty note with one section per field of the model.
• Create note from selection turns highlighted text into a new card note.

✨ AI (optional)

• Generate field text (meanings, example sentences, translations) into an editable preview. Nothing touches your note until you press Write.
• Generate images for a card. They're stored in Anki's media folder and still display inside Obsidian.
• Language-aware. Set your learning language and your own language once, and results follow them.

Requirements

• Obsidian 1.13.0 or newer, desktop only. VocabWeave talks to Anki on your own computer, so Obsidian Mobile isn't supported.
• Anki with the AnkiConnect add-on (code 2055492159), running while you sync.

Quick start

1. Install AnkiConnect in Anki (Tools → Add-ons → Get Add-ons…, code 2055492159), then restart Anki.
2. Install VocabWeave from Settings → Community plugins → Browse, and enable it.
3. Open Settings → VocabWeave, press Connect, then create a profile by picking a deck, a note type, and a folder for new notes.
4. Run the command VocabWeave: Create new note, name it, and fill in the sections.
5. Press Sync in the VocabWeave sidebar. The card is now in Anki. 🎉

What a note looks like

A note is just properties plus one section per Anki field:

---
anki_deck: Japanese::N2
anki_model: Basic
---

## Front

薬

## Back

medicine; drug

After the first sync, VocabWeave adds a few properties of its own (such as anki_note_id) so it can update the same card next time. Leave them in place.

Commands

Assign hotkeys to any of them in Settings → Hotkeys.

AI providers

Add providers under Settings → VocabWeave. None are configured out of the box.

Each provider's base URL can be changed, so self-hosted and compatible endpoints work too. A provider pointing at localhost is labelled local.

Privacy & network use

• AnkiConnect (local): VocabWeave connects to AnkiConnect on your computer (http://localhost:8765 by default). It reads decks and note types, and creates, updates, or deletes notes and media.
• AI providers are off by default. Nothing leaves your computer until you add a provider yourself. Each provider is labelled cloud or local in settings.
• What is sent: when you press Generate or Add image, the active note's word and fields, your prompt, your language settings, and examples you approved earlier go to the one provider you picked. No other notes are read.
• API keys are stored in Obsidian's secret storage and sent only to their provider.
• No telemetry, analytics, or ads.

Troubleshooting

Something else? Open an issue. Steps to reproduce and your Obsidian/Anki versions help a lot.

Support ☕

VocabWeave is free and built in spare time. If it saves you time, you can buy me a coffee to keep it going.

Starring the repo and sharing it with other learners helps too. Thank you! 💛

Contributing

Bug reports and pull requests are welcome.

npm i                 # install dependencies
npm run dev           # build in watch mode
npm run build         # production build
npm run lint          # ESLint
npm run type-check    # tsc --noEmit
npm run test:unit     # Vitest
npm run format:write  # Prettier

License

0BSD © 2026 Andy Nguyen