居中的引文。
—— 署名
``` ## 卡片 站内文章卡片自动读取标题、摘要、封面： ```md ::post{slug="kaifa02/tonks-home-desktop-system"} ``` GitHub 仓库卡片（已有，信息加载依赖 GitHub 网络）： ```md ::github{repo="DrTonks/tonks-blog"} ``` 音乐扩展使用已有的 `audio`，需要真实音频地址；不会自动播放： ```md ::audio{src="/audio/example.mp3" title="音频标题"} ``` 音频放在 `public/audio/`，也支持 HTTPS 地址。上面路径是占位示例，需要替换为实际文件。 ## 图片与图注 ```md   ``` 独占一段的图片自动居中，不加外框，并保留加载效果。小字图注放在 title，显示在图片下方；alt 用于无障碍描述。图片文件名的大小写必须完全匹配。 ## 脚注 ```md 这句话有补充说明[^note]。 [^note]: 角标支持悬停、聚焦或点击查看；启用预览后不再显示文末注释区。 ``` 这句话有补充说明[^note]。 [^note]: 角标支持悬停、聚焦或点击查看；启用预览后不再显示文末注释区。 ## 隐藏内容 ```md :spoiler[悬停即可阅读的内容] :::spoiler{warning="包含结局，确定继续阅读吗？"} 需要确认后再显示的内容。 ::: ``` 普通隐藏内容可点击固定展开；警告模式确认后，本次阅读不再重新遮挡。隐藏内容不是加密。 悬停即可阅读的内容 需要确认后再显示的内容。 ## 视频嵌入 可写 HTML iframe。请使用平台提供的嵌入地址，提供 title，并关闭标签： ```html ``` ## 落款 ```md :::signature Tonks · 2026 年 9 月 6 日 ::: ``` 参考文章的落款使用右对齐的一列表格，标准 Markdown 也能渲染；这里提供专门的指令，避免借用表格语义。 Tonks · 留给下一次写作的备忘 ## 引用中的不同字体 截图里的特殊字形来自局部 `font-family: serif`，不必更换整篇文章字体。可以用以下系统宋体风格辅助类；不同设备的实际字体略有差异： ```html「记录当下，也给未来留一扇窗。」
—— Tonks · 写作笔记
``` 也可以直接写 `局部文字`。只对需要的段落应用即可，列表与解释文字仍使用正文默认字体。 若要各设备显示完全一致的某款字体，需要自行提供 WOFF2 字体文件，而不是仅写一个设备未必安装的字体名称。将文件放到 `public/assets/font/`，再在 `src/styles/article.css` 定义，例如： ```css @font-face { font-family: "ArticleSerif"; src: url("/assets/font/article-serif.woff2") format("woff2"); font-display: swap; } .custom-md .my-serif { font-family: "ArticleSerif", serif; } ``` 然后在文章里写 `文字
`。这是配置示例，本项目没有附带这个占位字体文件；请替换成你准备使用的字体。中文字体通常较大，按实际用字裁剪可减少下载量。 ## 主题文字与表格卡片 粗体与列表标记会使用当前主题的强调色；正文链接保留下划线，悬停时出现轻量背景。无需额外添加 HTML 或颜色参数，在亮蓝、亮黄、暗蓝、暗黄主题下会自动适配。 表格也不需要新的指令，标准 Markdown 表格会自动放进卡片容器。表头有主题底色，手机上可以在卡片内部横向滚动；对齐方式仍由冒号的位置决定。 ```md | 功能 | 状态 | 数量 | | :--- | :---: | ---: | | 普通投票 | 可使用 | 2 | | 单选答题 | 可使用 | 3 | ``` | 功能 | 状态 | 数量 | | :--- | :-: | -: | | 普通投票 | 可使用 | 2 | | 单选答题 | 可使用 | 3 | ## 文章投票 在希望展示的位置插入 `poll` 指令即可。选项为单选，支持 2–8 项；选择后点击提交，才会显示各选项的比例与参与人数。只有两个选项时，还会出现单独的左右比例对比条。组件使用系统字体，并跟随网站主题。 ```md :::poll{id="guide-reading-v1" title="你更喜欢哪种阅读方式？"} - [a] 纸质书 - [b] 电子书 ::: ``` 互动投票或提问：请到原文参与，本文不包含选项、答案和结果。 `id` 必须在整个博客中唯一；复制示例到另一篇文章时，一定要更换。`[a]`、`[b]` 是稳定的选项编号，不是勾选状态。调整顺序时保留原编号，不要把历史票数对应到另一个选项。 同一共享 Cookie 身份只能投一次，再次访问会恢复已经选择的结果。它不是实名验证，清除 Cookie 或换设备仍可能成为新的身份。 ## 单选答题 答题复用投票组件，增加 `answer` 指定正确选项编号，`explanation` 提供提交后的解析： ```md :::poll{id="guide-markdown-quiz-v1" title="哪一种写法表示 Markdown 粗体？" answer="b" explanation="两个星号包围文字表示粗体；一个星号表示斜体，反引号表示行内代码。"} - [a] 一个星号包围文字 - [b] 两个星号包围文字 - [c] 反引号包围文字 ::: ``` 互动投票或提问：请到原文参与，本文不包含选项、答案和结果。 提交后会标记自己的选择、正确答案，显示选择比例和解析。网站接口在投票前不会返回答案或比例；但 Markdown 源码中的答案不是秘密，公开仓库和这篇教程的代码示例都能被阅读，因此适合互动小测验，不适合保密考试。 发布后的题目不要直接改含义 题目同步到后端后，标题、选项文字、答案和解析都将固定。需要更正或换题时使用新的 `id`，旧投票数据不会被重新解释。只调整选项顺序时可以保留原 ID。 投票卡片底部的「参与讨论」复用文章段评弹窗，评论和回复也会汇入文章底部留言区。普通投票无需先投票即可讨论；提问必须先作答（答对或答错都可以），才能查看和发表该题的评论、回复。未作答时，文章底部也会隐藏该题的整棵讨论树和对应计数。管理员模式可直接审核全部讨论。讨论绑定稳定的投票 ID，调整位置不会丢失；更换 ID 则视为新题。 ## 编辑器预览与发布 Obsidian 的格式菜单提供“文章投票”和“单选答题”。离线预览可以模拟选择，显示的是模拟结果，不会提交真实投票。表格和四种主题也使用博客的共享样式。 本地想连同评论、投票接口一起测试，可以运行： ```sh pnpm dev:comments-preview ``` 它需要相邻目录中的 sleepy 项目和对应 Python 依赖，使用本地预览数据库，不需要先构建文章映射。只运行普通 `pnpm dev` 时，接口取决于本机已有的代理配置。 正式发布时，先保证云端后端已支持投票，再执行 `pnpm ship`。构建只提取非草稿、非加密文章的投票；在发布前私下同步定义，失败则停止发布。真实互动块会从 AI 摘要输入与 RSS/Atom 正文中略去，教程中主动写出的代码示例仍会保留。