[Maoyao233]

问题

/qa/faq/ 页面的脚注区块被渲染了两次，页面底部出现两个「附注」小节：

<h3>附注</h3><section class="footnotes">…</section>
<h3>附注</h3><section class="footnotes">…</section>

原因

VitePress 自 v2.0.0-alpha.19 起已内置脚注渲染：它依赖 @mdit/plugin-footnote，由 markdown.footnote 选项控制且默认为 true，引用式 [^1] 与行内 ^[...] 语法均可直接使用。

而项目在 docs/.vitepress/config.mts 中又通过 md.use(markdownItFootnote) 额外注册了 markdown-it-footnote。两者会各自注册 footnote 相关的 core 规则（footnote_tail / footnoteTail），且共用同一个 env.footnotes，因此解析结束后各追加一次脚注区块，最终输出两份。

该问题在升级到 alpha.19+ 之后才会出现 —— 本仓库在 #53 升级到 2.0.0-alpha.20 后即可复现。

修改

移除冗余的 markdown-it-footnote：

• docs/.vitepress/config.mts：删除 import 与 md.use(markdownItFootnote)
• package.json / pnpm-lock.yaml：移除 markdown-it-footnote 与 @types/markdown-it-footnote

保留了自定义的 footnote_block_open 渲染规则，以继续显示「附注」标题（该标题由 e6cd314 特意添加，VitePress 原生输出不带标题）。

验证

pnpm docs:build 通过，/qa/faq/ 页面：

片段	修复前	修复后
<h3>附注</h3>	2	1
class="footnotes"	2	1

脚注改为 VitePress 原生输出，锚点双向可用：

<sup class="footnote-ref"><a href="#footnote1">[1]</a><a class="footnote-anchor" id="footnote-ref1"></a></sup>
…
<li id="footnote1" class="footnote-item">…<a href="#footnote-ref1" class="footnote-backref">↩︎</a></li>

输出使用的 footnotes / footnote-item / footnote-ref / footnote-backref 类名均为 VitePress 主题 vp-doc.css 已有的样式，无需额外 CSS。