zblog
文章项目关于

zblog

持续记录技术、产品与日常工作。

阅读

文章归档

关于

关于项目
GitHub@zenor0Email[email protected]
RSS站点地图
闽 ICP 备 2024047059 号
Powered by zblog

Copyright 2026 zblog. 保留所有权利。

返回列表
2026年5月21日 15:251 分钟阅读3 次阅读简体中文版本历史

Markdown 能力展示文章

端到端覆盖当前 Markdown 渲染能力的 seed 示例文章。

Seed Hero GraphicSeed asset for previewing image rendering inside the blog frontend.署名: Generated by local seed script

Markdown 能力展示

这篇 seed 文章专门用来展示博客前端当前支持的 Markdown 能力,包括引用 [1]、文内交叉引用、表格 caption、callout、代码块和基础排版。

Callout 展示

下面这一组例子专门展示 GitHub 风格 callout 在当前前端里的语义差异,以及自定义 label 的 fallback 效果。

Note

适合补充背景信息、阅读上下文或不影响主结论的说明。

Tip

适合给出更高效的写作、编辑或排版建议。

Important

适合标记读者在继续阅读前必须知道的约束条件。

Warning

适合强调误用风险、兼容性限制或功能边界。

Caution

适合提示可能导致错误发布、数据丢失或不可逆修改的操作。

Research Notes

自定义 label 也会被渲染为 callout,可用来承载团队特定语义。

文本与链接

你可以在正文里混合使用 粗体、斜体、inline code 和普通链接,例如 Payload CMS 文档。

当一套内容系统开始支持引用、图表和结构化代码块时,它就不只是“能发文章”,而是开始具备技术出版的骨架。


列表与提示块

  • 无序列表适合快速罗列能力点。
  • 有序列表适合展示步骤。
  • callout 适合强调上下文或风险。
  1. 先写正文。
  2. 再补引用。
  3. 最后检查文内交叉引用是否正确落点。

图表与交叉引用

下方的 [图 1] 和 [表 1] 分别展示了图片锚点和表格 caption 的文内引用能力。

Seed hero showcase
图 1. Seed asset for previewing image rendering inside the blog frontend.Generated by local seed script
FeatureStatus
Citation bibliographyNative
Figure referencesNative
Table captionsNative
Rendered markdown componentsNative
TSX fenced blocksNative
表 1. 前端 Markdown 能力矩阵

受控组件渲染

下面这两个例子展示了白名单组件的渲染能力。语法看起来像 TSX,但并不会执行任意代码,只会映射到系统内置组件。

info
受控组件渲染

这里的正文仍然走 Markdown 解析,所以你可以继续使用 强调、链接和普通段落。

原生支持
Citation
文内锚点
Figure refs
标题显示
Table captions
受控渲染
TSX-like blocks

代码块

下面是一段 tsx fenced code block,应该被渲染为带语言标签的代码块,而不是组件执行结果。

tsxexport function NoticeCard({ title }: { title: string }) {
  return (
    <section className="notice-card">
      <h3>{title}</h3>
      <p>This remains a code example rather than executable JSX.</p>
    </section>
  )
}

小结

如果你需要一篇文章同时验证标题目录、引用、图片、表格、callout、排版和代码块,这一篇就是系统能力的完整样本。

标签

markdownshowcaseseed

参考文献

参考文献1 条参考文献
  1. [1]

    Jane Smith, John Doe (2024). Designing Blogs that Respect References.

    Journal of Digital Writing 12(2), 10-32

    smith2024 · article · 简体中文

阅读进度

目录

0%
  1. Callout 展示
  2. 文本与链接
  3. 列表与提示块
  4. 图表与交叉引用
  5. 受控组件渲染
  6. 代码块
  7. 小结