需求是「写 Markdown,但中间要能插完整 HTML 且正常渲染」。逐个元素试了下面这些。
可折叠details
点我展开
里面的内容在浏览器里可正常渲染:
- 列表能识别
- 加粗 能识别
行内代码能识别
内联 style 的 div
🚀
flex 布局在 Markdown 里也正常
说明 HTML 是透传的,不是被转义成字符串
带自定义属性的元素
原生 script
下面的按钮就是文章正文里的原生 JS 直接控制的:
点了之后文字会变。这说明正文里的 <script> 在构建时被保留,并且浏览器端真的执行了。
表格
| 写法 | 是否生效 | 说明 |
|---|---|---|
| Markdown 表格 | ✅ | 自动包 <table> |
裸 <table> |
✅ | 原样透传 |
内联 style |
✅ | 属性保留 |
<details> |
✅ | 常用折叠 |
<script> |
✅ | 浏览器端执行 |
结论
.md 文件里裸 HTML 直接过,不需要任何配置。不用换.mdx(那会引入 JSX 语法约束)。
对比一下Hugo:它用 Goldmark,默认unsafe = false,裸 HTML 会被静默吞掉,必须显式开markup.goldmark.renderer.unsafe = true。踩过这个坑。