Markdown 代码块
最后更新：2026-10-14
代码块 CommonMark 核心
用三个反引号 ``` 包裹并标注语言名，创建带语法高亮的围栏代码块。这是写技术文档最核心的语法，本站教程里的所有代码示例都是这个写法。
| 所属分组 | 基础·块级 |
|---|---|
| 规范层级 | CommonMark 核心 |
| 规范版本 | CommonMark 0.31.2 + GFM |
📝 语法
```js
代码内容
```▶ 在线示例
在左侧编辑 Markdown，右侧实时看效果
💡 要点
💡 提示 标注语言名才有语法高亮：js、python、css、html 等主流语言都支持。
⚠️ 注意 围栏内的 Markdown 语法完全不解析——展示源码时这是优点，想显示星号就把内容放代码块里。
❓ 常见问题
Q 代码里本身有反引号怎么办？
A 用更多反引号当外层围栏：内层有 3 个，外层就用 4 个及以上。
Q 缩进代码块和围栏代码块怎么选？
A 一律推荐围栏式：可标注语言、无需 4 格缩进、在列表里更可控。
Q 波浪线 ~~~ 也能开围栏吗？
A 能，``` 和 ~~~ 都是标准围栏，~~~ 的优点是内容里有反引号也天然安全。
📚 相关条目
缩进代码块CommonMark 核心 行内代码CommonMark 核心