本站内容样式展示
内容提要
本文是站点内容样式验收文章,展示 Markdown、Liquid 与主题组件的渲染效果,涵盖标题、列表、引用、提示块、表格、代码高亮、图片灯箱、相册、Feature row、视频嵌入、脚注、Details 折叠块及公式语法边界。文末附覆盖清单,要求新增组件同步更新本页与验收条件,并检查明暗模式、窄屏、键盘与触屏体验。
延伸解读
样式验收页的定位与使用场景
这篇文章不是普通博客,而是站点内容样式的验收页。它使用真实的共享模板、Markdown 解析器和主题组件,覆盖从标题、列表到视频嵌入的各类元素。当调整阅读样式时,可以先在这里检查渲染效果,再进入博客、项目等内页核对真实内容,避免只检查短文章而遗漏边界情况。
解析器能力边界:公式与扩展语法
文章明确指出,当前解析器使用双美元符号作为行内和块级公式定界符,但主题没有加载 MathJax 或 KaTeX,因此公式只展示语法,不会实际渲染。此外,Mermaid、自动 Emoji、::: callout 和 Obsidian wiki link 也没有相应渲染器。这些边界被记录在覆盖清单中,提醒读者不要误以为所有 Markdown 方言都受支持。
维护约定:新增组件需同步更新验收页
文末的覆盖清单要求,新增内容组件时必须同时补充本页、覆盖清单和验收条件。修改共享 CSS 后,需要检查明暗模式、窄屏、键盘、触屏、图片灯箱与代码复制。外部播放器和 Gist 应单独报告实际网络结果,不把资源不可达误判为主题支持不存在。这为长期维护提供了明确的检查流程。
Q&A
本站内容样式展示这篇文章的主要用途是什么?
这是一篇站点内容样式验收文章,用于展示 Markdown、Liquid 与主题组件的渲染效果,并作为长期验收的参考页面。
文章展示了哪些内容组件?
文章展示了标题、列表、引用、提示块、表格、代码高亮、图片灯箱、相册、Feature row、视频嵌入、脚注、Details 折叠块及公式语法边界等组件。
新增内容组件时需要同步更新什么?
新增内容组件时,应同时补充本页、覆盖清单和验收条件。
修改共享 CSS 后需要检查哪些方面?
修改共享 CSS 后,需要检查 light / dark 模式、窄屏、键盘、触屏、图片灯箱与代码复制。
文章中的视频嵌入支持哪些平台?
视频嵌入支持 Bilibili、YouTube、Vimeo 和 Google Drive。
文章中的公式语法是如何表示的?
行内与块级公式都使用双美元符号,例如 $$E = mc^2$$。单个 $...$ 不是当前解析器的公式定界符。