区块语法的介绍/使用
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 语法,包括标题、列表、代码区块等:
这是一个标题。
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码:
return shell_exec("echo $input | $markdown_script");
再加一点,看着上面的代码块,颜色突然结束,怪怪的
4 列表
2017.9.14 四 15:30
无序:星号、加号、减号
有序:数字接英文句点
1.也可以html标记
- 无序ol
- li,
- 这里 数字 排序了
- 一段markdown结束,最好加空行加以区分
2.数字不影响排序
- bird
- 数字是几不重要
- 比如这个的数字是:1,3,5
- 这个数字是二,但排序仍是4
懒惰的写法,建议第一个项目最好还是从 1. 开始,因为 Markdown 未来可能会支持有序列表的 start 属性。
3.列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
- 前面三个空格
第二行,后面没有空格 ,一个空格不会换行 - 前面三个空格,后面一个空格
第二行了。。有tab的可以换行 - 都是三个缩进,好看
- 三个缩进
第二行没空格, markdown不好看
4.列表项目间用空行分开,内容用
标签包起来
- bird
前面没有空行
前面加了一个空行,
- 只加了一个,就都有空行了
5.列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:
第一项,第一段,第一行
第一项,第一段,第二行第一项,第二段,第一行。。段落间前面要有空行
第一项,第二段,第二行。。段落间前面要有空行第二项,第一段,第一行。。前面没有空行–不需要要你过来区分段落 。加不加空行,输出是一致的
第二项,第二段,第一行。。每行都有缩进,看起来比第一段,没有所经的好看点
sdfsfsf算法
你每行都有缩进,看起来会看好很多
6.如果要在列表项目内放进引用,那 > 就需要缩进:
项目列表里有引用了
这里需要缩进
这里需要缩进,符号后面的空格好像不重要前面没有换行。所以这一个前面加了空行
前面没有换行。所以这一个前面加了空行,或者上一个加了一个制表符tab的是一个引用,空行就换成另一个引用了
7.如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个 空 格或是 2 个制表符:
===============
/*
* 这个符号前面也要加空格 >这个引用的符号,前面 竟然 不需要加空格
*/
- 这个符号前面也要加空格
这个引用的符号,前面 竟然 不需要加空格
- 星号加空格可以知道是一个markdown标签;可以没有回车换行。
这个引用的符号,前面 竟然 不需要加空格
- 这是个数字列表没有表现出来
- 这是个数字列表没有表现出来
这个引用的符号,前面 竟然 不需要加空格
这是个数字列表没有表现出来。加tab换行,只是换了一行,还是一个引用。。
加了一个空行——回车换行就表现出来了
- 加了一个空行——回车换行就表现出来了
================
- 代码块列表项,2个tab
- 代码块列表项,2个tab
斯蒂芬森斯蒂芬森
斯蒂芬 - 斯蒂芬 斯蒂芬森
8.项目列表很可能会不小心产生:1986. What a great season.
- What a great season.
- 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 都会帮你处理
© & >
& < >
© & > < >
4.代码区块中,一般的 Markdown 语法不会被转换,像是星号便只是星号,这表示你可以很容易地以 Markdown 语法撰写 Markdown 语法相关的文件。
***
6 分隔线
三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
前后都有段落时
前后都有段落时
## 三、区段元素
### 1 链接
### 2 强调
### 3 代码
### 4 图片
## 四、其他
### 1 反斜杠
### 2 自动链接
## 五、感谢
## 六、Markdown免费编辑器