Markdown 语法 · 代码
Markdown 代码块怎么写？
行内代码、围栏代码块、语言高亮
Markdown 里显示代码就靠一个字符:反引号。一个反引号括住一个词是行内代码,三个反引号上下夹住是多行代码块。核心就这么点。
AI 回答里代码块特别多(ChatGPT、Claude 几乎每段代码都围起来),搞懂它才好读、好改、好留存这些代码。这篇讲清行内代码、围栏块、加语言高亮,以及代码块为什么有时不渲染。
还没搞懂整体语法?先看 Markdown 怎么写。
三种显示代码的方式
| 类型 | 怎么写 | 什么时候用 |
|---|---|---|
| 行内代码 | 单个反引号括起来 | 句子里的命令、文件名或短片段 |
| 围栏代码块 | 三个反引号各占一行、上下各一 | 多行代码，原样保留 |
| 围栏块 + 语言 | 开头围栏后写语言名 | 想高亮的多行代码（在支持的渲染器里） |
合起来——注意反引号就是全部诀窍:
行内代码用单个反引号：
先运行 `npm install`。
围栏代码块用三个反引号，可带语言名：
```js
function hello() {
console.log("hi");
}
```
开头围栏后面的 "js" 指定语言，
在支持高亮的渲染器里会上色。行内代码 vs 围栏块
- 行内代码留在句子里——用于单个命令、一个
文件名.md、或一个短值。两边各一个反引号。 - 围栏块自成一段——用于任何多行内容。里面原样保留;代码块里 Markdown 格式是关掉的,所以你的
#、*、_会原样显示。
加语言让它高亮
在开头围栏后面写语言名——js、python、bash 等。支持高亮的渲染器会给代码上色;这个标签本身不改变什么,只是标明语言。可选,但长片段加上会好读很多。
代码块为什么不渲染
| 症状 | 怎么回事 | 怎么修 |
|---|---|---|
| 代码块没渲染成代码 | 开头或结尾的围栏缺了、不对齐 | 三个反引号各自单独一行、上下都有 |
| 没有语法高亮 | 开头围栏后面没写语言 | 在开头围栏后写语言名（js、python…） |
| 代码里本身有围栏 | 代码含一段三个反引号 | 外层改用四个反引号来围 |
| 行内代码提前截断 | 行内代码里出现了反引号 | 用两个反引号括，里面那个才当字面 |
头号原因:围栏不成对。开头和结尾都得各自单独占一行反引号、那行别有别的——多一个空格、或漏了收尾围栏,后面整篇就都变成代码了。
用 NoteLoom 读写代码块
用记事本打开一个满是代码的 .md,看到的是一堆生反引号。NoteLoom 是个在浏览器里读写本地 md 文件的编辑器:它的 reading 视图把围栏块渲染成干净的等宽块,source 视图让你写的时候把围栏写对。
先说清边界:NoteLoom 没有任何 AI——不会替你写代码、跑代码、讲解代码。它只打开、显示、存回你本地的 Markdown;代码是你自己的。
这在 AI 编程工具的规则文件里尤其常见——AGENTS.md、CLAUDE.md 里全是命令和代码。用 NoteLoom 打开那个文件夹,把代码块看清,在 source 视图里改,直接存回本地,不上云、不用账号。
FAQ
Markdown 里怎么写行内代码？
用单个反引号把文字括起来，会以等宽字体嵌在句子里——适合命令、文件名或短片段。如果代码里本身有反引号，就用两个反引号括，里面那个才会正常显示。
多行代码块怎么写？
用围栏代码块：一行三个反引号，下面写你的代码，再一行三个反引号收尾。里面的内容原样保留——代码块里不套用任何 Markdown 格式。
怎么让代码高亮？
在开头围栏后面写语言名，比如三个反引号后接 python 或 js。支持高亮的渲染器会据此上色。这个标签不改变代码本身，只是标明语言。
代码块为什么不渲染？
几乎总是围栏问题：开头或结尾那行三个反引号缺了、缩进怪、或行里有多余字符。三个反引号（或更多）要各自单独占一行、上下都有、那行别有别的东西。
我的代码里本身有三个反引号，怎么显示？
用比里面更多的反引号来围。如果代码里含三反引号围栏，就用四个反引号把整块围起来。规则：外层围栏只要比里面任何一段连续反引号都长就行。
NoteLoom 能帮我读写代码块吗？
能。NoteLoom 打开你本地的 .md，在 reading 视图里把围栏代码块渲染成干净的等宽块——比在记事本里看一堆反引号清楚多了——并让你在 source 视图里写对、改对围栏。它没有任何 AI：不会替你写代码、跑代码，只负责显示和存回你本地的 Markdown。
手机或 Safari 能用 NoteLoom 弄吗？
目前不行。NoteLoom 依赖浏览器的 File System Access API，当前支持 Chrome、Edge、Arc 这类 Chromium 系桌面浏览器；Firefox、Safari 和手机端暂不支持。
不用对着生反引号读代码
用 Chrome / Edge / Arc 打开 NoteLoom,挂载一个本地文件夹,打开任意 .md——reading 视图把围栏代码渲染干净,source 视图让你改对围栏。直接存回本地,不用装软件,也不用注册账号。