markdown学习笔记

来源:互联网 发布:中国到底多流氓知乎 编辑:程序博客网 时间:2024/06/06 15:04

Markdown 的目标是实现「易读易写」。

兼容HTML

Markdown 语法的目标是:成为一种适用于网络的书写语言。

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

HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。

要制约的只有一些 HTML 区块元素――比如 <div><table><pre><p> 等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能,不会在 HTML 区块标签外加上不必要的<p> 标签。在 HTML 区块标签间的 Markdown 格式语法将不会被处理。

HTML 的区段(行内)标签<span><cite><del> 可以在 Markdown 的段落、列表或是标题里随意使用。依照个人习惯,甚至可以不用 Markdown 格式,而直接采用 HTML 标签来格式化。举例说明:如果比较喜欢 HTML 的<a><img> 标签,可以直接使用这些标签,而不用 Markdown 提供的链接或是图像标签语法。和处在 HTML 区块标签间不同,Markdown 语法在 HTML 区段标签间是有效的。

特殊字符自动转换

html 中,< 与 & 应使用实体形式 &lt; &amp;

Markdown 让你可以自然地书写字符,需要转换的由它来处理好了。如果你使用的 & 字符是 HTML 字符实体的一部分,它会保留原状,否则它会被转换成&amp;

编辑器

在线markdown编辑器:csdn(使用发现,基本能满足需要), 简书等。

for windows :如markdownPad(学习时使用,但是免费版的很多功能都不能实现)。

for mac:如mou

区块元素

段落与换行

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

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

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

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

标题

两种形式

类setext:类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),任何数量的=- 都可以有效果。例如:

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

其他语法规则见csdn在线markdown编辑器语法帮助。