Don't do or do your best.

markdown 语法个人总结

Posted on By Jason Li


定义

Markdown 的理念:能让文档更容易读、写和随意改。

它是一种书写的格式,其格式语法只涵盖纯文本可以涵盖的范围。

具体语法

HTML 和 markdown

Markdown 中可以使用 HTML 语法,但区块元素——比如 <div>、<table>、<pre>、<p> 等标签要小心使用。

必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。

这里把html分为两个部分,块状元素和内联元素。块状元素和 markdown 语法只能有一个有作用,但内联元素和 markdown 可以互相嵌套。

其实完全可以用 html 来搞定一切。。。。。

所有的 markdown 语法使用后面要加以个空格。

特殊字符

使用实体形式

区块元素

换行和段落

插入至少一个空格行 或者 依赖 Markdown 来插入 <br /> 标签,在插入处先按入两个以上的空格然后回车 即可换行

标题

在文字开头以 # 的个数来控制几号标题。

或者用多个等于号表示一级标题,多个 - 来表示二级标题。

区块引用 Blockquotes

文字前用 > 即可

可用多个 > 表示嵌套(这是一个>)

这是两个

这是三个

	> 这是包裹在代码块里面的一个

列表

  • 加减文字均为无序列表,+ 号后面有四个空格
  1. 数字后接文字即有序列表,注意有四个空格。

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

代码区块

缩进4个空格即表示代码块,但每一行都需要缩进,一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。

在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体。这样我可以利用代码块,来找到我想要的特殊字符实体:

	大于号 > 
	小于好 <
	井号   #
	星号   *
	引号   '
	双引号 ""
	下线   _
	加号   +

这里看起来并没有转换是浏览器显示出实体字符了。

区段元素

链接

	<pre>[an example](http://example.com/ "Title")</pre>	

强调

* 将文字包起来表示加粗

反引号包裹表示高亮

还有更多内容,请参考官方文档