嘿,小朋友!你是不是以前看到别人写的文档里,那些代码像小黑板一样干干净净地嵌在里面,心里特别好奇?“哇,他是怎么做到的?背了好多奇怪符号吗?”
其实完全不用背!今天我就把这些“魔法方块”拆解给你看,保证你读完就能上手,连你班里的同学都会觉得你是隐藏的排版高手。
咱们先打个比方:写 Markdown 就像是在整理书包。如果你把乱七八糟的玩具全扔在一起,谁找得着?但如果你用一个个透明的小盒子把不同的玩具装好,贴上标签,那是不是既清楚又漂亮?
代码块,就是那个专门给“程序员代码”或者“复杂文字”用的透明小盒子。
有了这个盒子,里面的文字不会乱跑,字体也会变得像电脑屏幕里的等宽字体一样整齐。下面我给你准备了 5 个最常用的“盒子”配方,你直接复制粘贴就能用,连语法都不用记!
第一种:超级简单的“单行小贴纸”
有时候你只需要在一句话里提到一个短代码,比如告诉同学“记得按下 Ctrl+C 复制”。这时候你不需要搞那么大阵仗做一个大盒子,只需要给它加两个小弯钩(反引号)就行。
效果长这样:
记得按下
Ctrl+C复制
怎么做的呢?
其实特别简单,就是在英文输入法状态下,按一下键盘左上角那个 ~ 键,就能打出这个小符号 `。
复制配方:
在文字中间插入代码用 ``
举个例子,你想在文章里说:
“这个函数的名字叫 save_file,别忘了保存哦。”
你就这样写:
这个函数的名字叫 `save_file`,别忘了保存哦。
是不是超简单?就像给一个字贴上了一个小小的透明胶带保护罩!
第二种:最常用的“多行大盒子”
这是你以后用得最多的格式!当你想展示一段长长的代码,或者想让别人看清楚好几行文字的时候,就要用这个。
效果长这样:
def hello_world():
print("你好,世界!")
print("这是第二行")
复制配方:
```语言名
这里是你的代码
**注意细节:**
1. 三个反引号 ````` 要独占一行。
2. 第一行三个反引号后面,可以写上语言的名字(比如 `python`、`javascript`、`html`)。写了这个名字,代码就会有颜色高亮,看起来像专业编辑器一样漂亮!如果不写,就是黑白的,也没关系。
3. 第二行开始写你的代码。
4. 最后一行再用三个反引号 ````` 闭合。
**真实场景:**
假设你在教小朋友写 Python 代码,你想展示一个简单的加法程序:
**你这样写:**
```markdown
```python
a = 5
b = 3
print(a + b)
**别人看到的效果就是:**
```python
a = 5
b = 3
print(a + b)
看,代码自动缩进,颜色区分,是不是特别清晰?
第三种:懒人专属的“直接缩进法”
有些 Markdown 编辑器(比如某些论坛、知乎、或者 VS Code 的预览模式)支持一种更懒的写法。你不需要打反引号,只需要在代码前面空 4 个空格 或者按一下 Tab 键。
效果长这样:
def example():
print("我在缩进里")
复制配方:
(这里请按4个空格或者Tab键)
你的代码内容
下一行代码
为什么要提这个? 因为有时候你只是想快速把一段文字变成代码块,又不想记得那三个反引号怎么敲。比如你在写笔记,突然想标注一段配置内容:
Host: localhost
Port: 8080
User: admin
只要前面有空格,它就会被当成“代码块”显示出来,而且没有语言高亮,就是纯文本的样子。这对整理一些配置项特别有用!
第四种:带高亮的“彩色语法块”
这个其实是第二种的进阶版。很多小朋友会问:“为什么别人的代码红红绿绿的,我的都是黑的?”
秘诀就在第一行那个语言名称上!不同的语言有不同的“颜色密码”。
常见的“颜色密码”对照表:
| 语言名 | 效果预览 |
|---|---|
python |
Python 代码,关键词变蓝 |
javascript |
JS 代码,字符串变绿 |
html |
网页标签变橙色 |
css |
样式属性变蓝 |
bash 或 shell |
命令行指令,命令变黄 |
json |
数据格式,键名变蓝 |
sql |
数据库查询,关键字变红 |
复制配方:
```bash
git push origin main
npm install react
**真实场景:**
你想教小朋友怎么用命令行去更新一个软件,你可以这样写:
```markdown
```bash
# 第一步:进入文件夹
cd my-project
# 第二步:安装依赖
npm install
# 第三步:启动项目
npm start
**别人看到的效果:**
```bash
# 第一步:进入文件夹
cd my-project
# 第二步:安装依赖
npm install
# 第三步:启动项目
npm start
你看,连注释都被标黄了,命令也突出了,是不是像真的在终端里一样?
第五种:防翻车用的“转义反引号”
这个有点难,但小朋友要是学会了,就是真正的“高手级别”了!
你有没有遇到过这种情况:你想解释“怎么使用反引号”,结果你自己写出来的反引号把代码块给提前关掉了,结果格式全乱了?
错误示例:
你想在代码里写 ` 这个符号,但是如果你直接写,可能会出问题:
看,上面这个例子如果直接发出去,后面的文字可能会变得很奇怪,因为 Markdown 以为代码块结束了。
解决方法:用 (三个反引号)来包裹含有反引号的代码!
复制配方:
````
这里可以放任何包含 ` 反引号 的文本,都不会乱哦
````
真实场景: 假设你在写一本教别人学 Markdown 的书,你需要告诉读者:“如果代码本身包含反引号,就用三个反引号来包裹。”
你可以这样写:
这是一个包含 ` 符号的代码块
别人看到的效果:
这是一个包含 ` 符号的代码块
是不是绝了?这就好比当你手里有一把钥匙,却要打不开的门时,你换了一把更大的钥匙!
总结一下,5 个配方记心间
为了让你记得更牢,我把它做成了一张“口诀表”:
- 一句话里用代码 -> 用一对
`包起来。 - 多行代码展示 -> 用三对 ` 上下包起来,中间写上语言名更漂亮。
- 懒得打符号 -> 开头空 4 个空格。
- 想要五颜六色 -> 第一行写上
python、js等语言名。 - 代码里有反引号 -> 用四对 包起来。
为什么我们要学这个?
你可能会问:“反正都是文字,直接打字不行吗?为什么要搞这么麻烦的代码块?”
想象一下,如果你在网上教别人写代码:
没有代码块:
def hello(): print(“hi”) 然后输入 python hello.py
别人看着是不是很晕?哪句是代码,哪句是说明?
有了代码块:
这是你的函数:
def hello(): print("hi")然后运行:
python hello.py
是不是一下子就清楚多了?代码块就像是一个“隔离区”,让代码保持原样,不被人误读,也不会在网页上乱跑。
而且,现在大部分的技术博客、GitHub 文档、甚至是飞书和钉钉的文档,都支持 Markdown。你学会了这 5 种写法,以后无论是写作业、写报告,还是将来长大想成为程序员,这都是你的“超能力”之一!
下次再看到别人用漂亮的代码块,你就知道,他们并没有背什么复杂的语法,只是机智地复制了这几个小配方而已。
加油,小小排版大师!
