DEMO ARTICLE / 示例文章 / 工程化
用 MDX 组织可交互技术内容(Demo)
在 Markdown 的阅读体验中嵌入 Astro 组件,让说明、提示与代码示例保持一致。
Demo 说明:这是一篇用于验证 MDX 组件渲染能力的示例文章。
Markdown 很适合写作,组件很适合表达可复用的视觉语义。MDX 把两者放进同一份内容文件中。
内容与界面分工
文章只负责提供信息,组件负责视觉表现。以提示块为例,文章作者只需写:
<Callout title="注意">
这里放需要强调的内容。
</Callout>
如果未来需要调整圆角、颜色或间距,只改组件即可,不必批量修改文章。
保持克制
MDX 并不意味着每段文字都要变成组件。标题、段落、列表和代码块继续使用标准 Markdown,只有真正需要复用行为或样式的部分才组件化。
验证清单
- Frontmatter 能通过内容 schema 校验
- 组件路径有效且可在构建期渲染
- 不依赖浏览器 JavaScript 的组件仍输出静态 HTML
- 文章在移动端没有横向溢出