行内代码
\n行内代码的格式很简单,只需要使用两个 ` 将代码内容包裹起来即可,比如 var foo = \'bar\';
缩进显示代码
\n要在 Markdown 中创建代码块也很简单,只要简单地缩排 4 个空白或是 1 个 tab 就可以,例如,下面的输入:
\n这是一个普通的段落:
\nThis is a code block.\n
\n
在 Markdown 会转换成:
\n```html
\n这是一个普通的段落:
\n\nThis is a code block.\n
\n
```
\n这个每行一级的缩排(4 个空白或是 1 个 tab),都会被移除,例如:
\n这里是一段示例代码:
\ntell application "Foo"\n beep\nend tell\n
\n
会被转换为:
\n```html
\n这里是一段示例代码:
\n\ntell application "Foo"\n beep\nend tell\n
\n
```
\n一个代码块会一直持续到没有缩排的那一行(或是文档结尾)。
\n在代码块里面, &
、 <
和 >
会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入 HTML 的原始示例代码,例如:
<div class="footer">\n © 2004 Foo Corporation\n</div>\n
\n
会被转换为:
\n```html
\n<div class="footer">\n © 2004 Foo Corporation\n</div>\n
\n
```
\n高亮显示代码段
\n除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,创建高亮显示的代码段时,将代码段由带有三个反引号( ``` )的行围起来,并在第一个围栏的末尾标识上语言类型即可,比如:
\njavascript\n// A highlighted block\nvar foo = \'bar\';
```javascript\n// A highlighted block\nvar foo = \'bar\';\n```\n
\n
也可以不指定语言类型,比如
\necho "Hello"
```\necho "Hello"\n```\n
\n
Diff 语法
\n此外,Markdown 还支持 Diff 高亮语法,其格式如下
\ndiff\nvar foo = \'bar\';\n- var x = 200;\n+ var x = 100;
```diff\nvar foo = \'bar\';\n+ var x = 200;\n* var x = 100;\n```\n
\n
需要注意的是,如果差异内容中包 `,请确保使用反斜杠\\
来转义每个反引号` ,否则差异突出显示将无法正确呈现。
小结
\n让我们来回顾一下代码块的知识点吧:
\n- \n
- 用两个 ` 将代码内容包裹起来就是一个行内代码\n
- 缩进 4 个空白或是 1 个 tab 可以创建一个缩进代码块\n
- 在代码块的前后各使用三个反引号( ``` )把需要高亮显示的代码包裹起来,并在第一个 ``` 的末尾标识上语言类型就可以创建一个高亮代码块\n