← 返回主页

在 Markdown 里插完整 HTML,实测记录

details/summary、内联 style、原生 script、带自定义属性的 div —— 逐个试一遍。

需求是「写 Markdown,但中间要能插完整 HTML 且正常渲染」。逐个元素试了下面这些。

可折叠details

点我展开

里面的内容在浏览器里可正常渲染:

  • 列表能识别
  • 加粗 能识别
  • 行内代码 能识别

内联 style 的 div

🚀
flex 布局在 Markdown 里也正常
说明 HTML 是透传的,不是被转义成字符串

带自定义属性的元素

自定义属性和 data-* 都保留了

原生 script

下面的按钮就是文章正文里的原生 JS 直接控制的:

点了之后文字会变。这说明正文里的 <script> 在构建时被保留,并且浏览器端真的执行了。

表格

写法 是否生效 说明
Markdown 表格 ✅ 自动包 <table>
裸 <table> ✅ 原样透传
内联 style ✅ 属性保留
<details> ✅ 常用折叠
<script> ✅ 浏览器端执行

结论

.md 文件里裸 HTML 直接过,不需要任何配置。不用换.mdx(那会引入 JSX 语法约束)。

对比一下Hugo:它用 Goldmark,默认 unsafe = false,裸 HTML 会被静默吞掉,必须显式开 markup.goldmark.renderer.unsafe = true。踩过这个坑。