Markdown学习(二)区块元素

段落和换行

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行(空行的定义是显示上看起来像是空的,便会被视为空行。比方说,若某一行只包含空格和制表符,则该行也会被视为空行)。

「由一个或多个连续的文本行组成」 这句话其实暗示了 Markdown 允许段落内的强迫换行(插入换行符),这个特性和其他大部分的 text-to-HTML 格式不一样,其它 text-to-HTML的格式会把每个换行符都转成 <br/> 标签。但如果你确实想要依赖 Markdown 来插入 <br/> 标签的话,在插入处先按入两个以上的空格然后回车。

Markdown 中 email 式的 区块引用 和多段落的 列表 在使用换行来排版的时候,不但更好用,还更方便阅读。

标题

Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。

类Setext

类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)

This is an H1
=============

This is an H2
-------------

展示效果如下:

This is an H1

This is an H2

任何数量的 = 和 - 都可以有效果。

类atx

类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶

# 这是 H1
## 这是 H2
###### 这是 H6

可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的# 数量也不用和开头一样(行首的井字符数量决定标题的阶数):

# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######

区块引用 Blockquotes

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

效果如下

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 > :

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

效果如下

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等

列表

Markdown 支持有序列表和无序列表。

无序列表使用星号、加号或是减号作为列表标记。比如:

*   Red
*   Green
*   Blue

有序列表则使用数字接着一个英文句点,无论你前面的数字是否连续,都会以第一行的数字进行递增显示。比如:

3. Bird
1. McHale
8. Parish

效果如下:

  1. Bird
  2. McHale
  3. Parish

列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符。

如果要在列表项目内放进引用,那 > 就需要缩进(4 个空格或是 1 个制表符)。

如果要放代码区块的话,该区块就需要缩进两次( 8 个空格或是 2 个制表符)。

行首出现数字-句点-空白,而你并不是需要出现列表效果,你可以在句点前面加上反斜杠,Markdown就不会显示数字-句号-空白显示。

代码区块

照原来的样子显示排版好的代码区块,Markdown 会用 <pre><code> 标签来把代码区块包起来。

在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,Markdown会自动将其装换为<pre><code></pre></code>标签。

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

在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,再加上缩进就可以了,剩下的 Markdown 都会帮你处理。

代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。

分割线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

* * *

***

*****

- - -
发布了2 篇原创文章 · 获赞 0 · 访问量 23

猜你喜欢

转载自blog.csdn.net/qq_39944594/article/details/105438912