用 Node.js 生成 Anki 卡片

使用 Node.js 22.13 或更高版本。在新的应用目录中运行：

mkdir anki-deck
cd anki-deck
npm install --include=optional ankiforge@0.3.1

这会安装公开 npm 包及匹配的原生可选依赖。平台覆盖范围见已验证环境。

导出牌组

将以下程序保存为 main.mjs：

import { Project, Note, BuildOptions } from 'ankiforge';

const project = new Project('spanish').defaultDeck('Spanish');
project.add('es:hola', Note.basic('hola', 'hello'));
const output = await project.build(BuildOptions.to('spanish.apkg'));
console.log(output.artifact.path);
await output.artifact.close();

node main.mjs

在 Anki 中打开持久保存的 spanish.apkg，其中 Spanish 牌组包含 hola → hello。后续编辑时保持命名空间 spanish 和键 es:hola 不变。关闭持久产物对象后，文件仍留在磁盘上。导出不需要安装 Anki。

TypeScript 与下一步任务

JSON 到 Anki 示例包含完整的 TypeScript 编译与运行流程。

ESM 使用 .mjs，CommonJS 使用 require('ankiforge')。包中附带 TypeScript 声明；参见 TypeScript 配置。

• 图片与音频及 Node 媒体 API
• 自定义笔记类型和模板包
• 图片遮挡
• 比较与更新
• Node API及排查问题

源码编译与本地打包见源码构建。