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. 在代码块的前后各使用三个反引号( ``` )把需要高亮显示的代码包裹起来,并在第一个 ``` 的末尾标识上语言类型就可以创建一个高亮代码块
目录
相关文章
|
1月前
|
程序员
【Markdown速成】半小时入门Markdown教程(后缀.md文件详解)
作为程序员我们经常会看到README.md这种说明文件,以.md为后缀的文件就是我们所说的Markdown的文件。
172 4
手把手教会你使用Markdown【从入门到精通一篇就够了】
手把手教会你使用Markdown【从入门到精通一篇就够了】
|
程序员 Perl
MarkDown入门学习总结教程
我们坚信写作写的是内容,所思所想,而不是花样格式.
148 0
MarkDown入门学习总结教程
|
搜索推荐 程序员 PHP
Markdown新手入门必知必会
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。
134 0
Markdown新手入门必知必会
MarkDown入门图片
MarkDown入门图片
128 0
MarkDown入门图片
|
Web App开发 数据安全/隐私保护 iOS开发
Markdown 入门 :文章目录生成、合并单元格、文章快速插入链接(使用剪切板的链接插到选中文字)【修订】
Markdown 入门 :文章目录生成、合并单元格、文章快速插入链接(使用剪切板的链接插到选中文字)【修订】
390 0
Markdown 入门 :文章目录生成、合并单元格、文章快速插入链接(使用剪切板的链接插到选中文字)【修订】
|
SQL 前端开发 JavaScript
原来 Markdown 代码块支持语言高亮
原来 Markdown 代码块支持语言高亮
590 0
原来 Markdown 代码块支持语言高亮
MarkDown入门表格
MarkDown入门表格
143 0
|
程序员 Perl
MarkDown入门分隔线及引用
MarkDown入门分隔线及引用
174 0
MarkDown入门列表
MarkDown入门列表
109 0