Obsidian美化（2026.08.11）

概念编号：009

一句话理解

Obsidian 美化，是通过主题、Style Settings、CSS 片段和界面配置，持续调整 Obsidian 显示层与编辑体验的实践。

具体解释

Obsidian 美化处理的是“知识如何被看见和编辑”，不直接改变 Markdown 内容的意义。它通常由几层配置共同组成：

• 主题：提供颜色、字体、间距、控件和整体视觉语言；
• Style Settings：把主题或片段里的 CSS 变量和开关变成可操作的设置；
• CSS 片段：对复选框、Callout、列表、编辑器等局部区域进行定制；
• 界面配置：控制字体、布局、文件树、编辑模式等使用体验；
• 输入模板：快速产生约定好的 Markdown 结构或任务状态，但本身不等于美化规则。

这些配置通常需要同时满足“语法存在、插件加载、主题规则匹配、编辑模式正确”四个条件。任何一层断开，都可能表现为“样式突然失效”。

边界与易混淆概念

• 不是 Obsidian 模板：模板主要负责复用内容结构和输入流程；美化主要负责显示层。
• 不是单个主题：AnuPpuccin、Minimal、Things 等是主题；Obsidian 美化是围绕主题、插件和 CSS 的组合实践。
• 不是 CSS 片段本身：CSS 片段是实现手段之一，启用状态和选择器是否匹配同样重要。
• 不是博客构建样式：Quartz 或其他静态站点的 CSS 只影响博客输出，不会自动影响 Obsidian 桌面编辑器。
• 不改变 Markdown 语义：例如 - [b] 收藏 仍然是任务文本；主题只是把它显示成书签等视觉状态。

例子

自定义复选框

复选框样式的实现链路是：

Templater 生成 - [x] / - [*] / - [b] / - [i]
        ↓
Obsidian 识别任务状态
        ↓
AnuPpuccin + Style Settings，或独立 CSS 片段
        ↓
Live Preview 与阅读视图显示图标

本次排查确认了两件事：Style Settings 不存放复选框图标，它只是读取 AnuPpuccin 的 class-toggle，把 anp-custom-checkboxes 加到 body；真正的图标、颜色和遮罩规则仍然在主题 CSS 中。

由于启用 Style Settings 会造成编辑卡顿，最终没有继续依赖插件，而是将 AnuPpuccin CUSTOM CHECKBOXES 区块复制为独立片段 .obsidian/snippets/【图标】AnuPpuccin复选框.css，去掉 .anp-custom-checkboxes 外层前缀，并保留 Live Preview 所需的 .HyperMD-task-line[data-task] 兼容选择器。关闭 Style Settings 后，目标笔记实际验证了 [x] 绿色勾选方框、[*] 橙色星形、[b] 红色书签和 [i] 蓝色信息图标。

快捷菜单预览

tp.system.suggester() 的默认实现只通过 setText() 渲染纯文本，不能直接把任务复选框或 HTML 节点放进选项。当前复选框输入模块保留原有的 Markdown 标记和值，再由 .obsidian/snippets/【图标】复选框菜单预览.css 针对 .templater-suggester-modal .suggestion-item 添加 CSS 图标。模板每次执行前会主动读取并注入这份 CSS，避免 Obsidian 尚未重新扫描代码片段；菜单中看到的是预览，选中后仍然只生成原来的 - [状态] 内容。

这个菜单预览片段依赖输入模块中的固定选项顺序；如果以后增删或重排选项，需要同步调整 CSS 的 :nth-child() 规则。实际任务行的显示仍由 【图标】AnuPpuccin复选框.css 负责，两者是分开的。

Canvas 默认连线兼容性

本次 AnuPpuccin Canvas 排查补充了另一个边界：主题、CSS 片段和 Obsidian 核心 Canvas 样式之间，除了选择器覆盖关系，还存在颜色变量格式约定。AnuPpuccin v1.5.0 将 --canvas-color 作为 RGB 三元组使用；当 Canvas 的 SVG 连线样式直接把它当作完整 stroke 值时，默认连线和箭头可能不可见，而手动着色的连线仍然正常。

当前采用局部片段 .obsidian/snippets/【修复】AnuPpuccin Canvas连线.css，只对 g:not(.is-themed) 下的默认连线和箭头显式补上 rgb(...)。这保留了手动颜色，也避免直接修改主题主文件。完整的现象、证据和回滚方法见AnuPpuccin Canvas 连线不可见排查记录。

样式预览与配置备份

• 样式预览页：用于集中查看常用排版和主题效果。
• Style Settings配置：保存主题设置的可迁移配置。
• 复选框样式输入模块：快速产生自定义任务状态。
• .obsidian/snippets/【图标】AnuPpuccin复选框.css：不依赖 Style Settings 的最终复选框 CSS 实现。
• .obsidian/snippets/【图标】复选框菜单预览.css：快捷菜单中的 CSS 预览实现。
• .obsidian/appearance.json 与 .obsidian/community-plugins.json：CSS 片段和插件的启用状态。

相关概念

• Obsidian模板：复用文件结构、插件、主题和工作流的预设。
• Obsidian：Obsidian 工具与知识库主题入口。
• 自定义复选框样式失效的排查与修复：本概念的实际排查文章。
• AnuPpuccin Canvas 连线不可见排查记录：主题颜色变量与 Canvas SVG 连线不兼容的实际案例。

来源

• Obsidian 更新日志：2025 年 7 月 31 日的原始实现记录。
• Style Settings 配置：anp-custom-checkboxes 配置证据。
• 复选框样式输入模块：Templater 模板来源。
• 目标笔记：本次样式失效案例。
• AnuPpuccin Canvas 连线不可见排查记录：2026-08-11 的 Canvas 兼容性排查与修复。
• AnuPpuccin issue #383：Canvas edges are invisible by default：官方问题报告。

当前认识边界

当前概念卡基于本地主题文件、插件配置、历史更新日志和实际排查建立。已确认 Style Settings 是主题开关的 class/变量管理器，而不是图标来源；独立 CSS 方案已在目标笔记的编辑视图验证 [x]、[*]、[b]、[i] 四种状态。另已确认 AnuPpuccin Canvas 问题属于颜色变量格式与 SVG 连线样式之间的兼容边界，当前局部片段可在保留主题的前提下恢复默认连线；上游 issue 仍需等待主题或 Obsidian 进一步修复。快捷菜单预览依赖固定选项顺序，其他主题或主题升级后的状态覆盖范围，也需按当前版本逐项验证。

概念卡更新日志

• 2026.08.05｜创建概念卡：由 Obsidian 自定义复选框样式排查与修复资料抽象为「Obsidian美化」，登记为 009。
• 2026.08.07｜更新：补入本地主题文件、插件配置、历史更新日志和实际排查结果，明确 Style Settings、CSS 片段与主题美化的边界。
• 2026.08.08｜维护：补建标准化概念卡更新日志；未改变既有概念正文与关系。
• 2026.08.11｜更新：补入 AnuPpuccin Canvas 默认连线不可见案例，明确主题 RGB 变量、SVG 连线选择器与局部 CSS 修复之间的关系；概念编号仍为 009。