· 2 分钟阅读

Markdown 元素演示文章

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

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

这篇文章用于验证中文博客在 MDX 场景下的排版能力,涵盖标题层级、引用、表格、代码高亮、图片以及第三方内容嵌入。

标题层级

中文内容通常更考验标题的换行与留白,因此建议在博客详情页里保留清晰的层级与足够的段落间距。

三级标题示例

适合用于章节内的小节说明或操作步骤的拆分。

四级标题示例

当文档较长时,可以继续使用更细的层级来组织内容。

引用

一个好的内容模板,不只是能展示文本,还应该能稳定展示图文、代码和嵌入模块。

列表

有序列表示例

  1. 先准备内容结构
  2. 再确认页面视觉风格
  3. 最后补全 SEO 和多语言信息

无序列表示例

  • 适合整理要点
  • 适合整理检查项
  • 也适合写产品优势

表格

模块作用是否建议中文化
标题传达主题
按钮引导行动
图片文字强化理解
代码块技术演示视情况

代码块

const locale = 'zh';

const labels = {
  send: '发送咨询',
  back: '返回博客列表',
};

图片

Super wide

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

Not so big

MDX 组件

Jianlin Group

Astro Embed

YouTube

Play

Tweet

View this post on X

https://twitter.com/Steve8708/status/1598713161339015173

Vimeo

返回博客列表