本站内容样式展示

💡 原文中文,约22400字,阅读约需54分钟。
📝

内容提要

本文是站点内容样式验收文章,展示 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$$。单个 $...$ 不是当前解析器的公式定界符。

🏷️

标签

➡️

继续阅读