· AstroWind 中文站 · 文档 · 2 分钟阅读
中文 Markdown / MDX 排版演示
用一篇文章检查博客的中文排版效果:标题、列表、表格、代码、引用与链接。这个文件是 .mdx,用来验证 MDX 渲染链路。
这篇示例不参与索引,只用来检查中文内容在博客模板里的显示效果。文章放在 src/data/post/,扩展名可以是 .md 或 .mdx,两者都会由 Content Layer 在构建时读取。
二级标题
正文段落用来观察行高与字距。加粗、斜体、站内链接 与 行内代码 是最常见的几种行内元素。中文段落不需要手动断行,交给浏览器按宽度换行即可。
三级标题
- 无序列表第一项
- 无序列表第二项,里面放一个
config.yaml之类的文件名 - 无序列表第三项
- 有序列表第一项
- 有序列表第二项
- 有序列表第三项
表格
| 文件 | 作用 | 是否常改 |
|---|---|---|
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 插件与暗色模式样式都工作正常。接下来可以回到中文指南列表继续读其他文章。