Anki Inline Card Links / 行内卡片链接

View a related card, then return to your original review.
点击关联词查看目标卡，看完返回原卡继续学习。

Version / 版本：0.2.1

English

What it does

Anki Inline Card Links lets you insert links to other cards directly into a note field. During a review or card preview, clicking a link opens the selected card in a separate viewer. You can reveal its answer, follow another link, and return step by step to the original card.

The linked-card viewer has no rating buttons and does not answer or reschedule cards. Rate your original card normally after closing the viewer.

This is useful for vocabulary relationships, definitions, related concepts, prerequisites, contrasting examples, or any situation where you want to consult another card without losing your place.

Main features

• Insert a link with Ctrl+Shift+L or the editor's 🔗 button.
• Search existing cards using a word or an Anki search query.
• Select the target by its title, a short field summary, and deck name; duplicate labels receive an additional number.
• Show a readable word or phrase instead of a raw card ID.
• Open the target in a separate viewer using Anki's native card rendering flow.
• Reveal the answer and continue through linked cards, up to 20 viewer levels.
• Return with Esc or Return to previous card; close the window to exit all levels.
• Keep the original review card's side, scroll position, and expanded page elements in place.
• Pause the original review's automatic advance timers while the viewer is open; resume them only if the original card is unchanged and Anki is still reviewing.
• Recognize both the current link format and older links that retain their target metadata.

Compatibility

This release was tested on Windows desktop Anki 26.9.2. Its version guard also permits 26.8.1, which was not retested in the current validation round.

The AnkiWeb download branch is restricted to 26.9.2. The broader internal guard does not mean intermediate versions are supported; use the file distribution for 26.8.1 only with the stated validation limitation.

The supported-version list is deliberately narrow. Other Anki versions require validation before they can be enabled. macOS and Linux have not been verified. This add-on runs in desktop Anki; its linked-card viewer is not available in AnkiMobile, AnkiDroid, or the AnkiWeb review interface.

No AnkiConnect, external service, API key, or additional Python package is required. The add-on has a Chinese interface; this description is provided in both English and Chinese.

Installation

From AnkiWeb: use the add-on code displayed on this page in Anki's Tools → Add-ons → Get Add-ons dialog, then restart Anki completely.

From a file: open Tools → Add-ons → Install from file, select the .ankiaddon file, and restart Anki completely. If you downloaded the full source ZIP, extract it first and select the .ankiaddon inside it; do not install the full source ZIP as the add-on.

Avoid installing duplicate copies under different add-on directory names. When changing between a local installation and an AnkiWeb installation, check that only one copy is enabled.

Insert your first link

1. Open the Add or Edit window for the source note.
2. Put the cursor in a field that your card template actually displays. You may place the link beside a definition, beside an image, or in a dedicated related-concepts field. If text is selected, inserting the link replaces that selection.
3. Press Ctrl+Shift+L or click 🔗.
4. Search for the target word or use an Anki search query. For a generic example, a note about one concept can link to a card explaining a related concept.
5. Choose the correct card using the title, summary, and deck name, then save the edit.
6. Open a review or card preview and click the link. If the field appears only on the answer side, reveal the answer first.

In the editor, the inserted link normally looks like ((target word)). In a review or preview, it becomes a clickable target word.

Typing double parentheses by hand does not create a link. Neither does applying blue text or an underline. The insertion command saves the exact target card ID as well as the label.

Viewer controls

• Click a card link: open the target's question side.
• 显示答案 / Space: show the current target's answer.
• Click another link inside the viewer: open the next linked card.
• 返回上一张 / Esc: return one level; at the first level, exit the viewer.
• Window close button: exit all viewer levels immediately.
• 重播音频 / R: replay audio for the current target.

When you return to a previous card inside the viewer, its side and scroll position are restored, but that card is rendered again. Arbitrary temporary state created by its template scripts may not survive. The original review page is kept in place rather than replaced.

Automatic audio follows the target card's Anki settings. Returning to the previous card does not automatically replay its audio. Audible media playback has not been separately verified in this release's validation.

Where links are stored

Links are saved in the edited note field as HTML. The current format stores a target ID in an address beginning with https://anki-inline.invalid/card/. This is a local identification marker, not an external lookup service. During review or preview, the add-on converts the marker to a local click command.

Links refer to a specific card in the current collection, not merely to a word. Deleting and recreating a card can invalidate its link. Imported, moved, or rebuilt collections should be checked for correct targets; the add-on does not automatically remap links by their visible labels.

Installing or sharing this add-on does not include any deck, note, media, or pre-existing card links. Each user creates links to cards in their own collection.

Troubleshooting

A link does nothing in the editor.
The editor is the insertion and editing interface, not this add-on's linked-card viewing interface. Test the link in a review or card preview.

A link is not visible on the card.
Save the note, check that the template displays the edited field, and check the answer side if necessary. The add-on does not automatically add fields to templates.

Blue text or ((text)) does not open a card.
The saved content may be plain styled text without a target ID. Remove that old text and insert a fresh link using the target chooser. Older links work only when their identifying metadata is still present.

The target is missing or the link is marked as broken.
Search for the intended card again and reinsert the link. The add-on does not silently connect a broken link to another card with the same title.

Too many results, or the expected candidate is absent.
Narrow the Anki query. This version considers the first 500 matching cards and shows at most 50 candidates. It prioritizes exact headword matches, then prefixes, then other matches within that set. Select duplicate titles carefully using their summary and deck.

An update seems ineffective.
Quit Anki completely and reopen it. Check for duplicate add-on installations.

Anki reports an unsupported version.
Use a supported desktop version or validate the code against the newer Anki APIs in an isolated collection before changing the guard.

Privacy, validation, and license

The distributed add-on contains code and license/documentation files, not personal paths, accounts, collection databases, note exports, media, or diagnostic backups. The add-on itself has no telemetry, upload, or external service request code. Its searches read the active local Anki collection, and insertion writes a link into the selected note field.

Anki's normal synchronization, card templates, media, and other add-ons have their own data and network behavior; this statement applies to this add-on's implementation.

The verified runtime passed 39 Python tests, 5 JavaScript tests, and 33 real Anki checks in an isolated Windows / Anki 26.9.2 collection. Real checks covered editor insertion and saving, actual click handling, answer display, nested navigation, returning, original-page state, timers, and unchanged scheduling/review records. This is not a guarantee for every template or combination of add-ons.

Version 0.2.1 uses standard href storage for target IDs and supports intact legacy link metadata. The viewer uses an independent native preview flow instead of replacing the scheduled review card.

Distributed under AGPL-3.0-or-later. Editable Python and JavaScript source is included in the add-on package. Keep the source, license, copyright, and attribution notices when redistributing; mark modifications and their dates. See the bundled COPYING.txt, LICENSE.md, and NOTICE.md, or the full AGPL license. Native preview rendering is adapted from Anki's Previewer. This is an independent add-on, not an official Anki release.

中文

插件用途

Anki Inline Card Links 可以在笔记字段中直接插入指向其他卡片的链接。学习或预览时，点击链接会打开独立的目标卡查看窗口；可以显示答案、继续查看下一张关联卡，再逐级返回原卡。

查看窗口没有评分按钮，不会替目标卡作答或修改卡片排程。退出查看窗口后，在原学习界面正常评分即可。

适用于单词关系、定义、相关概念、前置知识、对照例子等场景，方便学习时查阅另一张卡并保持原来的学习位置。

主要功能

• 使用 Ctrl+Shift+L 或编辑器 🔗 按钮插入链接。
• 输入单词或 Anki 搜索条件查找现有卡片。
• 根据标题、字段摘要和牌组选择目标；相同候选标签附加编号。
• 显示可读的单词或短语，而不是原始卡片 ID。
• 使用 Anki 原生卡片渲染流程，在独立窗口查看目标卡。
• 支持显示答案和连续跳转，最多同时查看 20 层关联卡。
• 使用 Esc 或“返回上一张”逐级返回，关闭窗口退出全部层级。
• 保持原学习卡的正反面、滚动位置和展开内容。
• 查看期间暂停原卡自动翻面/下一张计时器；退出时仅在原卡未变且仍在学习状态下恢复。
• 兼容新链接格式和保留了目标标识的旧链接。

兼容范围

本版已在 Windows 桌面 Anki 26.9.2 上验证。版本守卫也允许 26.8.1，但本轮没有重新实测该版本。

AnkiWeb 下载分支仅开放 26.9.2。内部守卫允许两个版本，不表示支持它们之间的所有版本；26.8.1 使用文件分发时仍需注意上述验证限制。

支持版本范围较窄，其他 Anki 版本需要先验证。macOS、Linux 尚未验证。插件运行在桌面 Anki；AnkiMobile、AnkiDroid 和 AnkiWeb 网页学习界面没有本插件的关联卡查看窗口。

不依赖 AnkiConnect、外部服务、API 密钥或额外 Python 包。插件界面为中文，本说明提供英文和中文两种版本。

安装方式

从 AnkiWeb 安装： 在 Anki 的“工具 → 插件 → 获取插件”中输入本页面显示的插件代码，然后完全退出并重开 Anki。

从文件安装： 打开“工具 → 插件 → 从文件安装”，选取 .ankiaddon 文件，再完全退出并重开 Anki。如果下载的是完整源码 ZIP，先解压，再选择里面的 .ankiaddon；不要将整个源码 ZIP 当作插件安装。

不要在不同插件目录下重复安装。本地安装切换为 AnkiWeb 安装时，检查并确保只有一份启用。

第一次插入链接

1. 打开源笔记的添加或编辑窗口。
2. 将光标放在卡片模板实际显示的字段里。中文定义旁、图片旁或单独的关联词字段均可。已有文字被选中时，插入会替换选中内容。
3. 按 Ctrl+Shift+L 或点击 🔗。
4. 搜索目标单词，或输入 Anki 搜索条件。例如，某个概念的笔记可以关联到解释另一个相关概念的卡片。
5. 根据标题、摘要和牌组选择正确的目标卡，然后保存编辑。
6. 在学习或卡片预览中点击链接。如果该字段只显示在背面，先显示答案。

编辑器中通常显示 ((目标词))；学习或预览时显示可点击的 目标词。

仅手打双括号不会创建链接。 将文字设为蓝色或下划线也不够。插入功能会同时保存精确的目标卡 ID 和显示文字。

查看与返回

• 点击卡片链接： 打开目标卡正面。
• “显示答案” / 空格： 显示当前目标卡背面。
• 点击查看窗口中的另一个链接： 进入下一张关联卡。
• “返回上一张” / Esc： 返回一层；第一层返回时退出窗口。
• 窗口关闭按钮： 立即退出全部查看层级。
• “重播音频” / R： 重播当前目标卡音频。

在查看窗口内返回上一张卡时，会恢复其正反面和滚动位置，但这张目标卡会重新渲染，模板脚本产生的其他临时状态不一定保留。原学习页面保持原位，不会被目标卡替换。

自动播放遵循目标卡的 Anki 设置；返回上一张不自动重播音频。本轮没有单独验收实际可听见的媒体播放。

链接如何保存

链接以 HTML 形式保存在编辑的笔记字段中。新格式将目标 ID 放在以 https://anki-inline.invalid/card/ 开头的地址里。这是本地识别标记，不是远程查询服务；学习或预览渲染时，插件将其转换为本地点击指令。

链接绑定的是当前集合中的具体卡片，而不是单词文字。删除并重建卡片后，旧链接可能失效。导入、迁移或重建集合后，应检查目标是否仍然正确；插件不会按显示文字自动重新配对。

安装或分享插件不包含任何牌组、笔记、媒体或既有链接。每位使用者需要在自己的集合中创建关联。

常见问题

在编辑器里点击没反应。
编辑器用于插入和修改，不是本插件的关联卡查看入口。请到学习界面或卡片预览中测试。

卡片上看不到链接。
先保存笔记，确认模板显示了编辑字段；必要时显示答案。插件不会自动向模板添加字段。

蓝色文字或 ((文字)) 无法跳转。
保存的内容可能只有样式，没有目标 ID。删除旧文字，使用目标卡选择器重新插入。旧格式只有在识别属性仍然存在时才能工作。

目标不存在，或链接显示失效样式。
重新搜索目标卡并插入链接。插件不会把失效链接悄悄改绑到另一张同名卡。

结果太多，或没有预期的候选。
缩小 Anki 搜索条件。本版最多检查前 500 张命中卡、显示 50 个候选，在此范围内优先精确词头、其次前缀、最后其他命中。同名卡应结合摘要和牌组辨认。

更新后没有变化。
完全退出并重开 Anki，检查是否重复安装了插件。

提示 Anki 版本不支持。
使用支持的桌面版本；如果需要新版兼容，应先在隔离集合核对接口和运行验证，再调整版本守卫。

隐私、验证与许可

分发的插件包含代码、许可和说明文件，不包含个人路径、账号、集合数据库、笔记导出、媒体或诊断备份。插件自身没有遥测、上传或外部服务请求代码。搜索读取当前本地 Anki 集合，插入则将链接写入选定字段。

Anki 正常同步、卡片模板、媒体和其他插件各有自己的数据与联网行为；这里的说明仅针对本插件的实现。

当前运行代码通过 39 项 Python 测试、5 项 JavaScript 测试，以及 Windows / Anki 26.9.2 隔离集合中的 33 项真实检查。实机检查覆盖编辑器插入保存、实际点击、答案显示、连续跳转、返回、原页面状态、计时器以及排程/复习记录保持。不保证所有模板与插件组合都已验证。

0.2.1 使用标准 href 保存目标 ID，保留完整旧标识的兼容；目标卡通过独立原生预览流程显示，不再替换学习器当前排程卡。

以 AGPL-3.0-or-later 分发。安装包内含可编辑的 Python 和 JavaScript 源码；再次分发时保留源码、许可、版权及来源声明，修改后注明修改内容和日期。详见包内 COPYING.txt、LICENSE.md、NOTICE.md，或完整 AGPL 许可。原生预览渲染参考 Anki Previewer。这是独立插件，不是 Anki 官方发布。