Markdown 代码块最全速查（2025 年必会版）

用途	写法（直接复制）	渲染效果示例	适用平台 / 备注
行内代码	用反引号包起来 print("Hello")	print("Hello")	所有平台都支持
普通代码块	三个反引号（）或三个波浪线（~~~） | | 推荐用，兼容性最好
指定语言高亮	python<br>代码<br>	python<br>def hello():<br> print("Hi")<br>	几乎所有现代编辑器都支持 200+ 语言高亮
带文件名 + 高亮	python title="app.py" linenums="1"<br>代码<br>	文件名：app.py + 行号	Typora、Obsidian、语雀、掘金、Hexo、VuePress 支持
高亮指定行	python hl_lines="2 4-6"<br>代码<br>	第 2、4-6 行高亮	Obsidian、MkDocs、Typora（1.8+）支持
代码块标题/说明	python {1-3} title="核心代码"<br>代码<br>	带标题和行号	语雀、Notion、Obsidian 最新版支持

2025 年最常用的 8 种写法（直接抄）

1. 最简单（懒人）

console.log(“Hello World”)

2. 指定语言（推荐）

javascript
console.log(“Hello World”)

3. 带文件名 + 行号（技术博客最爱）

python
def main():
print(“我是第 3 行，会显示行号”)

4. 高亮重点行（面试/教程神器）

python
def add(a, b):
return a + b # 这行会被高亮
# 第 5-7 行也会高亮

5. 终端命令（带 $）

bash
$ npm install vue@3
$ echo “安装完成”

6. 代码对比（diff）

diff

• 旧代码（红色）
• 新代码（绿色）
  这行不变

7. 带复制按钮（部分平台自动有）
GitHub、语雀、掘金、Typora 1.9+ 右上角自动出现复制按钮

8. 超长一行自动换行（加 ?wrap）

python
very_very_very_long_variable_name = “这行超长也不会横向滚动，太爽了”

#### 各平台支持情况（2025 年最新）

| 功能                 | GitHub | 语雀 | Typora | Obsidian | 掘金 | Notion | VuePress |
|----------------------|--------|------|--------|----------|------|--------|----------|
| 语言高亮             | ✅      | ✅    | ✅      | ✅        | ✅    | ✅      | ✅        |
| 行号 linenums        | ❌      | ✅    | ✅      | ✅        | ✅    | ❌      | ✅        |
| 文件名 title         | ❌      | ✅    | ✅      | ✅        | ✅    | ❌      | ✅        |
| 高亮行 hl_lines      | ❌      | ✅    | ✅      | ✅        | ✅    | ❌      | ✅        |
| 一键复制按钮         | ✅      | ✅    | ✅      | ✅（插件）| ✅    | ❌      | ✅        |
| diff 高亮            | ✅      | ✅    | ✅      | ✅        | ✅    | ❌      | ✅        |

**结论**：  
写技术博客/文档/笔记时，强烈推荐用这套万能模板：

markdown
“`python title=”文件名.py” linenums=”1″

你的代码

第几行重点就手动高亮一下

想要我直接发一套超好看的「技术教程代码块模板包」吗？
包含：Python、JavaScript、Go、终端、JSON、Dockerfile、Git 命令…
30 种常用语言全配好文件名+高亮，直接复制粘贴就美炸！随时说～