· 2 分钟阅读
Markdown 元素演示文章
这是一篇中文版的 MDX 演示内容,用于验证标题、列表、表格、代码块、图片和嵌入组件在中文博客中的显示效果。

这篇文章用于验证中文博客在 MDX 场景下的排版能力,涵盖标题层级、引用、表格、代码高亮、图片以及第三方内容嵌入。
标题层级
中文内容通常更考验标题的换行与留白,因此建议在博客详情页里保留清晰的层级与足够的段落间距。
三级标题示例
适合用于章节内的小节说明或操作步骤的拆分。
四级标题示例
当文档较长时,可以继续使用更细的层级来组织内容。
引用
一个好的内容模板,不只是能展示文本,还应该能稳定展示图文、代码和嵌入模块。
列表
有序列表示例
- 先准备内容结构
- 再确认页面视觉风格
- 最后补全 SEO 和多语言信息
无序列表示例
- 适合整理要点
- 适合整理检查项
- 也适合写产品优势
表格
| 模块 | 作用 | 是否建议中文化 |
|---|---|---|
| 标题 | 传达主题 | 是 |
| 按钮 | 引导行动 | 是 |
| 图片文字 | 强化理解 | 是 |
| 代码块 | 技术演示 | 视情况 |
代码块
const locale = 'zh';
const labels = {
send: '发送咨询',
back: '返回博客列表',
};图片

中文博客除了文本翻译外,也要关注图片说明、替代文本和图像里的嵌入文字是否同步本地化。

MDX 组件

Astro Embed
YouTube
Tweet
View this post on X



