技术

小组件,大边界:在 MDX 里保持简单

用一个没有客户端脚本的提示组件,说明 MDX 如何服务内容,而不是让文章变成应用。

本文目录

这是一篇 MDX 示例。下面的提示块由 Astro 组件生成静态 HTML,不需要 React 水合。

给内容一点结构

普通 Markdown 仍然是主角

组件之外,标题、段落、列表与代码仍然照常书写。

<Note title="一个小提示">这里是提示内容。</Note>

边界比数量重要

让组件负责呈现,让文章保留内容。优先输出静态 HTML,只在用户确实需要交互的地方引入客户端代码。

判断标准可以写得更明确:如果去掉这个组件,内容还能被读懂,那它就只是一个容器;如果去掉之后语义会丢失——比如一段必须与正文区分开的提醒——它才值得存在。前者用 Markdown 就够了。

搜索