这是一篇 MDX 示例。下面的提示块由 Astro 组件生成静态 HTML,不需要 React 水合。
给内容一点结构
普通 Markdown 仍然是主角
组件之外,标题、段落、列表与代码仍然照常书写。
<Note title="一个小提示">这里是提示内容。</Note>
边界比数量重要
让组件负责呈现,让文章保留内容。优先输出静态 HTML,只在用户确实需要交互的地方引入客户端代码。
判断标准可以写得更明确:如果去掉这个组件,内容还能被读懂,那它就只是一个容器;如果去掉之后语义会丢失——比如一段必须与正文区分开的提醒——它才值得存在。前者用 Markdown 就够了。