· AstroWind 中文站 · 文档 · 2 分钟阅读

中文 Markdown / MDX 排版演示

用一篇文章检查博客的中文排版效果:标题、列表、表格、代码、引用与链接。这个文件是 .mdx,用来验证 MDX 渲染链路。

这篇示例不参与索引,只用来检查中文内容在博客模板里的显示效果。文章放在 src/data/post/,扩展名可以是 .md 或 .mdx,两者都会由 Content Layer 在构建时读取。

二级标题

正文段落用来观察行高与字距。加粗、斜体、站内链接 与 行内代码 是最常见的几种行内元素。中文段落不需要手动断行,交给浏览器按宽度换行即可。

三级标题

  • 无序列表第一项
  • 无序列表第二项,里面放一个 config.yaml 之类的文件名
  • 无序列表第三项
  1. 有序列表第一项
  2. 有序列表第二项
  3. 有序列表第三项

表格

文件作用是否常改
src/config.yaml站点信息与默认 SEO是
src/navigation.ts菜单与页脚是
src/content.config.ts文章字段校验很少
astro.config.ts集成、字体、图片偶尔

代码块

i18n:
  language: zh-CN
  textDirection: ltr
ui:
  theme: 'system'

代码高亮跟随站点主题:亮色用 github-light,暗色用 github-dark,配置在 astro.config.ts 的 markdown.shikiConfig 里。

引用

好的模板不是替你做完所有决定,而是把需要重复做的决定提前做完。

引用块适合放结论或提醒,但一篇文章里别用太多次。

分隔线与小结


如果上面这些元素在你的文章里显示正常,说明 Markdown 管线、Tailwind Typography 插件与暗色模式样式都工作正常。接下来可以回到中文指南列表继续读其他文章。

分享:
返回中文指南

相关文章

查看全部文章