markdown笔记.pdf

1. 概概述述 Markdown 语法全部由一些符号组成，其作用往往一目了然。其理念是:让文档更容易读写 修改。 通常 Markdown 是一种书写格式，而 HTML 是一种发布格式。 Markdown 涵盖范围之内的标签都可以在文档中用 HTML 撰写，无需额外标注这是HTML还是 Markdown ，只需要直接加标签即 可, Markdown 生成器会自动识别出这些 HTML 标签。 HTML 区块标签 （如 div , p 等）之间的 Markdown 格式语法将不会被处理。 HTML 行内标签 （如 span , cite , del 等）之间的 Markdown 格式语法是有效的，会被处理。 HTML 行内标签 （如 span , cite , del 等）可以在 Markdown 的段落，列表或者标题内随意使用。 根据个人习惯，你可以不使用 Markdown 格式，而完全采用 HTML 标签来格式化。 在 HTML 中， 用于起始标签； 用于结束标签； 用于标记 HTML 实体。如果你想显示这几个字符，必须用其实体形式： lt; – ; gt; – ; amp; – 。 在 HTML 中， ， ， 的显示形式有 Markdown 生成器自动处理。 如果 是组成HTML实体的字符的一部分，则它按照HTML实体解析。如 copy 解析为 © 。 如果 不是组成HTML实体的字符的一部分，则它转换成 amp; 。如 ATT 解析为 ATamp;T 。 依此类推。若将其作为 HTML 标签的定界符，则 Markdown 不做任何转换；否则就自动转换为 lt; , gt; 。 如果在 Markdown 的 code 元素作用范围内，则 , , 一定会被转成 lt; , gt; amp; 。 2. 区区块块元元素素 2.1 段段落落 一个 Markdown 段落是由一个或者多个连续的文本行组成，在其前后要有一个以上的空行(若它的前/后元素为其他区块元素也可以，但两个段 落之间必须有空行或者其他区块元素) 。 空行的定义是：显示上看起来像是空的，比如某一行只包含了空格或者制表符，则即可视为空行。 普通段落不能用制表符来缩进 若用制表符缩进，则 Markdown 生成器将其解析为 code 元素。 普通段落不能用空格缩进 若用空格缩进，则在 HTML 输出中没有效果。类似于 HTML ，在 Markdown 中多个空白符只会显示一个空格；若想显示多个空 格，参考 HTML 。且4个空格会被 Markdown 生成器将其解析为 code 元素 Markdown 允许段落内插入换行符，然而这并不会在生成的 HTML 输出中插入 br/ 标签。要想显示出换行，则有两个方法： 在插入处先按两个以上的空格，然后回车键；而不要直接按回车键 直接在需要换行的地方输入 br/ 标签 2.2 标标题题 Markdown 支持两种标题语法: 标题的前后不需要有空行 类Setext形式：底线式。用 = (最高阶)， - (第二阶）。其中 = 或者 - 的数量至少是一个以上即可。用法为: 为了美观你可以将 = 或 - 数量延长覆盖标题的所有内容 This is H1 ========== 以及 This is H2 类Atx形式：在行首插入1到6个# ，对应标题1～6阶。 你可以在行尾加上 # 来闭合Atx形式的标题，纯粹是为了美观。行尾的 # 数量不限。 通常建议 # 文字之间保留空隔，这是标准用法 （某些编辑器只支持标准用法） # This is H1 ## This is H2 ### This is H3 #### This is H4 ##### This is H5 ###### This is H6 2.3 区区块块引引用用 Markdown 区块引用使用类似email中的 ，看起来像是你首先断好行，然后在每行的行首添加 。 This is P1 line1 , This