什么是 Markdown 代码块?
在 Markdown 中,代码块用于展示编程代码、命令行指令或其他需要特殊格式化的文本内容。它能清晰地区分正文与技术内容,提升可读性。
行内代码(Inline Code)
使用反引号 ` 包裹单行简短代码:
这是一个 `console.log("Hello")` 示例。
多行代码块(Fenced Code Block)
使用三个反引号 ``` 包裹多行代码:
```javascript
function greet() {
console.log("Hello, world!");
}
greet();
```
指定语言以启用语法高亮
在开头的三个反引号后加上语言标识(如 python、html、bash 等),可实现语法高亮(依赖渲染器支持):
```python
def fibonacci(n):
if n <= 1:
return n
return fibonacci(n - 1) + fibonacci(n - 2)
```
缩进式代码块(旧式写法)
每行前加 4 个空格或 1 个制表符(Tab),但推荐使用围栏式(fenced)代码块:
<p>这是 HTML 段落</p>
<script>
alert('不推荐这种方式');
</script>
小贴士
- 避免在代码块中使用不必要的转义字符。
- 确保代码块前后有空行,以保证正确解析。
- 在 GitHub、Typora、Obsidian 等平台中,围栏式代码块支持语法高亮。