您好, 欢迎来到 !    登录 | 注册 | | 设为首页 | 收藏本站

Markdown 代码块

1. 前言

关于块,Markdown 作者给出的定义如下:

预格式化块主要用于在 Markdown 文档中源风格的。相比普通的文本段落,块可以保留的多行换行、缩进等格式。

在 Markdown 文档中块,需要在每行的开头输入不少于 4 个空格符号或者 1 个 tab 符号。

原文出处:。

Markdown 作为一种排版工具语言,其作用是为了帮助我们处理一些常见的排版问题。但是我们仍有一些场景需要保留的原格式,例如不同的缩进、中间空格等。Markdown 通过块的方式处理需要保存格式的多行。

环境说明
考虑到 Markdown 工具之不兼容,有的直接从复制粘贴到本地不会正常,大家学习时自己动手写是肯定没问题的。本节所有实例及演示均使用 Typora 工具完成。

2. 语法详解

在 Markdown 中,在行首 4 个连续的空格,可将行定义为块。

实例 1

#### 使用空格定义块    pubic static void main(String[] args) {      Sy.out.println("Hello world");    }

其渲染结果如下:

注意:Typora 编辑器在认模式(实时渲染模式)下无法通过此块,需要先切换到源模式(「」->「源模式」)后空格。

该源码渲染 html 的如下:

<pre><div><span><span>pubic static void main(String[] args) {</span></span></div><div><span><span>  </span><span>Sy.out.println("Hello world");</span></span></div><div><span><span>}</span></span></div></pre>

块的另一种定义方式是以三个连续的 「反引号 “`”」 作为开始行和结束行。

实例 2

#### 使用反引号定义块```
pubic static void main(String[] args) {
  Sy.out.println("Hello world");
}
```

其渲染结果如下:

种方式下,我们还可以声明的高亮样式,是在首行的连续的三个 「反引号 “`”」 后面加入源语言的,比如:javascript、Markdown、json、java、c++、 等,具体的种类和使用的 Markdown 编辑器或渲染程序配置有关。

实例 3

#### 使用反引号定义块,并定义高亮```java
pubic static void main(String[] args) {
  Sy.out.println("Hello world");
}
```

其渲染结果如下:

3. 使用场景及应用实例

行内可以让我们很轻松的在中间诸如 <html> 的,而不需要手动转义。当我们编写程序说明文档时,或者其他需要在文档中插入特殊字符时,这个的作用会非常明显。

实例 4

画一张字符画。

#### 一张字符画```
.__           .__  .__                               .__       .___
|  |__   ____ |  | |  |   ____   __  _  _____________|  |    __| _/
|  |  \_/ __ \|  | |  |  /  _ \  \ \/ \/ /  _ \_  __ \  |   / __ |
|   Y  \  ___/|  |_|  |_(  <_> )  \     (  <_> )  | \/  |__/ /_/ |
|___|  /\___  >____/____/\____/    \/\_/ \____/|__|  |____/\____ |     \/     \/                                                  \/```

渲染结果如下:

4. 小结

当使用 4 个空格声明块时,转换后的文本会掉缩进的距离,也就是会从行首删掉 4 个空格,以保持格式;

当使用 4 个空格声明块时,块的结束声明在后面首个缩进不足 4 个空格的行;

常规的 Markdown 语义,比如「星号 *」在块中的转义作用失效。

「块」和「行内」都是方便于特殊字符,相比「行内」,「块」更有利于段落文本,表现出原文本的换行及缩进。


联系我
置顶