MarkDown入门代码块

简介: MarkDown入门代码块

Markdown 技能树(8):代码块

行内代码的格式很简单,只需要使用两个 ` 将代码内容包裹起来即可,比如 var foo = 'bar';

缩进显示代码

要在 Markdown 中创建代码块也很简单,只要简单地缩排 4 个空白或是 1 个 tab 就可以,例如,下面的输入:

这是一个普通的段落:

This is a code block.

Markdown 会转换成:

<p>这是一个普通的段落:</p>
<pre><code>This is a code block.
</code></pre>

这个每行一级的缩排(4 个空白或是 1 个 tab),都会被移除,例如:

这里是一段示例代码:

tell application "Foo"
    beep
end tell

会被转换为:

<p>这里是一段示例代码:</p>
<pre><code>tell application "Foo"
    beep
end tell
</code></pre>

一个代码块会一直持续到没有缩排的那一行(或是文档结尾)。

在代码块里面, &<> 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入 HTML 的原始示例代码,例如:

<div class="footer">
    &copy; 2004 Foo Corporation
</div>

会被转换为:

<pre><code>&lt;div class="footer"&gt;
    &amp;copy; 2004 Foo Corporation
&lt;/div&gt;
</code></pre>

高亮显示代码段

除了缩进显示代码段之外,Markdown 还支持高亮显示的代码段,创建高亮显示的代码段时,将代码段由带有三个反引号( ``` )的行围起来,并在第一个围栏的末尾标识上语言类型即可,比如:

// A highlighted block
var foo = 'bar';
```javascript
// A highlighted block
var foo = 'bar';
```

也可以不指定语言类型,比如

echo "Hello"
```
echo "Hello"
```

Diff 语法

此外,Markdown 还支持 Diff 高亮语法,其格式如下

var foo = 'bar';
- var x = 200;
+ var x = 100;
```diff
var foo = 'bar';
+ var x = 200;
* var x = 100;
```

需要注意的是,如果差异内容中包 `,请确保使用反斜杠\ 来转义每个反引号` ,否则差异突出显示将无法正确呈现。

小结

让我们来回顾一下代码块的知识点吧:

  1. 用两个 ` 将代码内容包裹起来就是一个行内代码
  2. 缩进 4 个空白或是 1 个 tab 可以创建一个缩进代码块
  3. 在代码块的前后各使用三个反引号( ``` )把需要高亮显示的代码包裹起来,并在第一个 ``` 的末尾标识上语言类型就可以创建一个高亮代码块
目录
相关文章
|
程序员 Perl
MarkDown入门学习总结教程
我们坚信写作写的是内容,所思所想,而不是花样格式.
112 0
MarkDown入门学习总结教程
MarkDown入门表格
MarkDown入门表格
101 0
|
程序员 Perl
MarkDown入门分隔线及引用
MarkDown入门分隔线及引用
139 0
MarkDown入门列表
MarkDown入门列表
85 0
MarkDown入门图片
MarkDown入门图片
79 0
MarkDown入门图片
|
Cloud Native
MarkDown入门链接
MarkDown入门链接
144 0
MarkDown入门标题
MarkDown入门标题
47 0
MarkDown入门段落及强调
MarkDown入门段落及强调
100 0
MarkDown入门MarkDown介绍
MarkDown入门MarkDown介绍
152 0
|
SQL 前端开发 JavaScript
原来 Markdown 代码块支持语言高亮
原来 Markdown 代码块支持语言高亮
531 0
原来 Markdown 代码块支持语言高亮