diegosouzapw Anki Card Generator
Generate Anki cards as Markdown, sync to Anki via AnkiConnect.
Core Concept
- 一个 .md 文件 = 一张卡片
- 文件夹 = 牌组
Directory Structure (示例)
project/
├── cards/ # 卡片源文件根目录（必需）
│ ├── python/ # → 牌组 "python"
│ │ ├── walrus.md # → 牌组 "python", 卡片 "walrus"
│ │ ├── f-string.md # → 牌组 "python", 卡片 "f-string"
│ │ └── tools/ # → 牌组 "python/tools"
│ │ ├── venv.md # → 牌组 "python/tools", 卡片 "venv"
│ │ └── pip.md # → 牌组 "python/tools", 卡片 "pip"
│ └── algorithms/
│ └── sorting/
│ ├── quicksort.md # → 牌组 "algorithms/sorting"
│ └── mergesort.md # → 牌组 "algorithms/sorting"
├── venv/ # Python 虚拟环境（必需）
└── .claude/skills/anki-card-generator/ # 本 skill（必需）
映射规则: cards/<folder>/<file>.md → 牌组 <folder>, 卡片来自文件
Card Format
# 卡片正面（H1 标题）
卡片背面内容
支持代码块、表格、列表等
- H1 = 卡片正面（若无 H1，则用文件名）
- H1 之后的内容 = 卡片背面
- SourceID =
hash(文件相对路径)
Content Best Practices
- Bullet points - 结构清晰，易于记忆
- Tables - 对比类知识一目了然
- Code blocks - 指定语言以启用语法高亮
- 💡 强调关键点或记忆技巧
- ⚠️ 标注易错点或注意事项
Example Card
文件: cards/python/walrus.md
# Python 海象运算符 `:=` 用法
`(x := value)` 在表达式中赋值并返回值
```python
if (n := len(data)) > 10:
print(f"Too long: {n}")
💡 Python 3.8+ 特性，避免重复计算
→ 牌组 `python`, 正面 "Python 海象运算符 `:=` 用法"
## Sync
**前置条件**: Anki 运行中 + AnkiConnect 插件 (code: `2055492159`)
```bash
# 1. 首次设置：创建 venv 并安装依赖
python -m venv venv
./venv/Scripts/pip.exe install requests
# 2. 同步卡片到 Anki
./venv/Scripts/python.exe .claude/skills/anki-card-generator/scripts/anki_sync.py
# 3. 预览变更（不执行）
./venv/Scripts/python.exe .claude/skills/anki-card-generator/scripts/anki_sync.py --dry-run
同步行为:
- 新文件 → 添加卡片
- 文件内容变更 → 更新卡片
- 文件删除 → 删除对应卡片（孤儿清理）
- 文件移动/重命名 → 视为删除旧卡 + 添加新卡（SourceID 变化）
Project Validation
同步前检查项目结构是否规范：
必须存在:
cards/- 卡片源文件目录venv/- Python 虚拟环境.claude/skills/anki-card-generator/- 本 skill
Markdown 文件检查:
- 每个 .md 文件应有 H1 标题（否则用文件名作为正面）
- H1 后必须有内容（不能为空卡片）
- 代码块正确闭合