定义
Markdown 的理念:能让文档更容易读、写和随意改。
它是一种书写的格式,其格式语法只涵盖纯文本可以涵盖的范围。
具体语法
HTML 和 markdown
Markdown 中可以使用 HTML 语法,但区块元素——比如 <div>、<table>、<pre>、<p> 等标签要小心使用。
必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。
这里把html分为两个部分,块状元素和内联元素。块状元素和 markdown 语法只能有一个有作用,但内联元素和 markdown 可以互相嵌套。
其实完全可以用 html 来搞定一切。。。。。
所有的 markdown 语法使用后面要加以个空格。
特殊字符
使用实体形式
区块元素
换行和段落
插入至少一个空格行 或者 依赖 Markdown 来插入 <br /> 标签,在插入处先按入两个以上的空格然后回车 即可换行
标题
在文字开头以 # 的个数来控制几号标题。
或者用多个等于号表示一级标题,多个 - 来表示二级标题。
区块引用 Blockquotes
文字前用 > 即可
可用多个 > 表示嵌套(这是一个>)
这是两个
这是三个
> 这是包裹在代码块里面的一个
列表
- 加减文字均为无序列表,+ 号后面有四个空格
- 数字后接文字即有序列表,注意有四个空格。
如果要放代码区块的话,该区块就需要缩进两次,也就是 8 个空格或是 2 个制表符
代码区块
缩进4个空格即表示代码块,但每一行都需要缩进,一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。
在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体。这样我可以利用代码块,来找到我想要的特殊字符实体:
大于号 >
小于好 <
井号 #
星号 *
引号 '
双引号 ""
下线 _
加号 +
这里看起来并没有转换是浏览器显示出实体字符了。
区段元素
链接
<pre>[an example](http://example.com/ "Title")</pre>
强调
* 将文字包起来表示加粗
反引号包裹表示高亮
还有更多内容,请参考官方文档