Markdown 语法说明(简体中文版) 二 区块

区块语法的介绍/使用

http://wowubuntu.com/markdown/#block

2017.9.11 一 am


## 一、概述
### 1 宗旨
### 2 兼容HTML
### 3 特殊字符自动转换

二、区块元素

1 段落和换行

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

2.「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown 允许段落内的强迫换行(插入换行符),这个特性和其他大部分的 text-to-HTML 格式不一样(包括 Movable Type 的「Convert Line Breaks」选项),其它的格式会把每个换行符都转成 <br /> 标签。

3.如果你确实想要依赖 Markdown 来插入 <br />标签的话,在插入处先按入两个以上的空格然后回车。

的确,需要多费点事(多加空格)来产生 <br /> ,但是简单地「每个换行都转换为 <br />」的方法在 Markdown 中并不适合, Markdown 中 email 式的 区块引用 和多段落的 列表 在使用换行来排版的时候,不但更好用,还更方便阅读。



2 标题

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

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

This is an H1

This is an H2

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

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

这是 H1

这是 H2

这是 H6

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

这是 H1

这是 H2

这是 H3



3 区块引用Blockquotes

打一段字,后面可以加空格接引用 > 这里是行内的引用 ??并不好使

This is a b,
This is a b,.
This is a b,

1.偷懒

只在整个段落的第一行加
这里是第二行

又一个段落了

2.嵌套引用

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

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

这是一个标题。

  1. 这是第一行列表项。
  2. 这是第二行列表项。

给出一些例子代码:

return shell_exec("echo $input | $markdown_script");

再加一点,看着上面的代码块,颜色突然结束,怪怪的



4 列表

2017.9.14 四 15:30
无序:星号、加号、减号
有序:数字接英文句点

1.也可以html标记


  1. 无序ol

  2. li,

  3. 这里 数字 排序了

  4. 一段markdown结束,最好加空行加以区分

2.数字不影响排序

  1. bird
  2. 数字是几不重要
  3. 比如这个的数字是:1,3,5
  4. 这个数字是二,但排序仍是4

懒惰的写法,建议第一个项目最好还是从 1. 开始,因为 Markdown 未来可能会支持有序列表的 start 属性。

3.列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。

  • 前面三个空格
    第二行,后面没有空格 ,一个空格不会换行
  • 前面三个空格,后面一个空格
    第二行了。。有tab的可以换行
  • 都是三个缩进,好看
  • 三个缩进
    第二行没空格, markdown不好看

4.列表项目间用空行分开,内容用

标签包起来

  • bird
  • 前面没有空行

  • 前面加了一个空行,

  • 只加了一个,就都有空行了

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

  1. 第一项,第一段,第一行
    第一项,第一段,第二行

    第一项,第二段,第一行。。段落间前面要有空行
    第一项,第二段,第二行。。段落间前面要有空行

  2. 第二项,第一段,第一行。。前面没有空行–不需要要你过来区分段落 。加不加空行,输出是一致的

    第二项,第二段,第一行。。每行都有缩进,看起来比第一段,没有所经的好看点
    sdfsfsf算法

你每行都有缩进,看起来会看好很多

6.如果要在列表项目内放进引用,那 > 就需要缩进:

  • 项目列表里有引用了

    这里需要缩进
    这里需要缩进,符号后面的空格好像不重要

    前面没有换行。所以这一个前面加了空行
    前面没有换行。所以这一个前面加了空行,或者上一个加了一个制表符

    tab的是一个引用,空行就换成另一个引用了

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

    ===============

    /*

    * 这个符号前面也要加空格
    >这个引用的符号,前面 竟然 不需要加空格
    

    */

  • 这个符号前面也要加空格

    这个引用的符号,前面 竟然 不需要加空格

  • 星号加空格可以知道是一个markdown标签;可以没有回车换行。

    这个引用的符号,前面 竟然 不需要加空格

  1. 这是个数字列表没有表现出来
  2. 这是个数字列表没有表现出来

    这个引用的符号,前面 竟然 不需要加空格

  3. 这是个数字列表没有表现出来。加tab换行,只是换了一行,还是一个引用。。

  4. 加了一个空行——回车换行就表现出来了

  5. 加了一个空行——回车换行就表现出来了

================

  • 代码块列表项,2个tab
  • 代码块列表项,2个tab
    斯蒂芬森斯蒂芬森
    斯蒂芬
  • 斯蒂芬 斯蒂芬森

8.项目列表很可能会不小心产生:1986. What a great season.

  1. What a great season.
  2. What a great season.
    1986.符号后面的空格还是很有用的。
    1986.符号后面的空格还是很有用的。前面那句话加了一个tab

============

/*
1986.符号后面的空格还是很有用的。前面那句话加了换行,所以是又一个markdown了。(没有空格,不是列表了)
*/

前面说的增量已经有了,(文档有些过时 --|--,我的哭脸呢)

1986. wahts sd s d
1986. wahts sd s d

/* 
1、发现:回车换行,相当与 p  标签,1加了换行,和间距,也就是段落的区分。2区分不同markdown语言   
tab也是换行,只是没有间距,同一个段落的换行

这个是回车换行,有间距,也就是段落的区分
2、markdown也有标签,和文本输出的概念。第一个/*  */,因为是直接在 语法####的下面,所以可以没有回车换行;后面两个必须加回车换行,和前面的文本(输出内容)做区分;和html表现一致
3、可能回车换行,换段落;tab,回车换行稍微有些绕。语法下直接写文本,好像也是markdown语法----html中直接输出文本。md中,要换另一个markdown,需要回车加一个空行,不然还会认为是直接输出文本....
4、tab====<br>  空行=====<p>  回车======html中的回车,并不会产出换行。。所以,tab 空行相当于markdown的标签
从这里面的颜色,也可以看出那些是markdown的语法----标签;
tab,空行,代码块,分隔符等,还有一些看不出来  
*/

====================

5 代码区块

缩进 4 个空格或是 1 个制表符
1.这个每行一阶的缩进(4 个空格或是 1 个制表符),都会被移除

前面四个缩进
    前面又加了四个缩进,第一个四个缩进被当做markdown语法识别了。代码里缩进一致,显得好看
    回车换了一行

    如果前面加了一个空行,,就变成段落了
前面还是四个缩进 。下面不加换行也是可以的,加换行代码清晰

2.一个代码区块会一直持续到没有缩进的那一行。(所以上面的代码快就可以不用加换行来区分了)(后面没有tab换行,下面的代码会接上来,成为一段内容)
3.在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,再加上缩进就可以了,剩下的 Markdown 都会帮你处理
© &         >
& < >

&copy; & > <      >   

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

***

6 分隔线

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





前后都有段落时


前后都有段落时

## 三、区段元素
### 1 链接
### 2 强调
### 3 代码
### 4 图片

## 四、其他
### 1 反斜杠
### 2 自动链接

## 五、感谢
## 六、Markdown免费编辑器

knowledge is no pay,reward is kindness
0%