[+] 2016年4月14日
%什么是 Markdown？

；2016/4/14 5:47:39

#Markdown 的定义

Markdown 是一种简单的标记语言，它可以被编译成 Html 页面，或者也可以单独以纯文本的形式呈现。

> LME 为实现一些专门功能，对 Markdown 语法进行了扩充。如果希望以纯 Markdown 文本的形式与他人交流，应避免使用这些扩展的语法。

+ Markdown 的目标是实现“易读易写”

对于 Markdown 文档来说，可读性是最重要的。

一份使用 Markdown 格式撰写的文件**应该可以直接以纯文本发布**，并且看起来不会像是由许多标签或是格式指令所构成。

> Markdown 语法受到一些既有 text-to-HTML 格式的影响，包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText，而最大灵感来源其实是纯文本电子邮件的格式。

总之， Markdown 的语法全由一些符号所组成，这些符号经过精挑细选，其作用一目了然。

> 比如：在文字两旁加上星号，看起来就像*强调*。Markdown 的列表看起来就是列表。Markdown 的区块引用看起来就真的像是引用一段文字，就像你曾在电子邮件中见过的那样。

+ 兼容 HTML

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

Markdown 的设计初衷不是想取代 HTML的地位。Markdown 的语法种类很少，只对应 HTML 标记的一小部分。

> 有些开发者认为 Markdown 的意义并不是使 HTML 文档更容易书写。他们认为 HTML 已经很容易写了。但实际上对于一个新手，要写 Html 仍然是个很困难的事情。而且，在学懂 Html 和 CSS 之前，也没办法用 Emmet 这样快速书写 Html 和 CSS 的神器。

正是由于 Html 其实足够复杂，所以Markdown 的`让文档更容易读、写和随意改`的理念就更有价值了。

HTML 是一种__发布的格式__，Markdown 是侧重于是一种__书写的格式__。

> 所以，Markdown 的格式语法__只涵盖纯文本可以涵盖的范围__，它也__不追求写特别复杂的页面__。

#在 Markdown 中使用 Html 标签

Markdown 没有定义的 Html 标签，都可以直接在 Markdown 文档中书写。

但是一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签，必须**在前后加上空行**与其它内容区隔开，还要求它们的**开始标签与结尾标签不能用制表符或空格来缩进**。

> 因为以四个空格或以一个制表符开头的行会被当作代码块——而代码块会原样输出到 Html 中。

例子如下，在 Markdown 文件里加上一段 HTML 表格：

    这是一个普通段落。

    <table>
        <caption>表格示例标题</caption>
        <tr>
            <th>表头01</th>
            <th>表头02</th>
        </tr>
        <tr>
            <td>单元格01</td>
            <td>单元格02</td>
        </tr>
        <tr>
            <td>单元格03</td>
            <td>单元格04</td>
        </tr>
    </table>

    这是另一个普通段落。

编译成 Html 页面会显示成这样：

{ Markdown 中嵌入 Html 标签的示例

这是一个普通段落。

<table>
    <caption>表格示例标题</caption>
    <tr>
        <th>表头01</th>
        <th>表头02</th>
    </tr>
    <tr>
        <td>单元格01</td>
        <td>单元格02</td>
    </tr>
    <tr>
        <td>单元格03</td>
        <td>单元格04</td>
    </tr>
</table>

这是另一个普通段落。

} 


请注意，在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如，你在 HTML 区块内使用 Markdown 样式的`*强调*`会没有效果。

HTML 的区段（行内）标签如 &lt;span&gt;、&lt;cite&gt;、&lt;del&gt; 可以在 Markdown 的段落、列表或是标题里随意使用。依照个人习惯，甚至可以不用 Markdown 格式，而直接采用 HTML 标签来格式化。举例说明：如果比较喜欢 HTML 的 &lt;a&gt; 或 &lt;img&gt; 标签，可以直接使用这些标签，而不用 Markdown 提供的链接或是图像标签语法。

> 和处在 HTML **区块**标签间不同，Markdown 语法在 HTML **区段**标签间是有效的。

例如：

    这是带<span style="color:red;">色彩并**加粗**    </span>文本。

编译为 Html 会呈现为这样：

这是带<span style="color:red;">色彩并**加粗**</span>文本。

---

如果是简单的二维文字表，可以不使用 Html 标签，而是简单地写成下面这样：

    ｜   表格示例标题   ｜
    ｜==================｜
    ｜ 表头01 ｜ 表头02 ｜
    ｜:-------｜:-------｜
    ｜单元格01｜单元格02｜
    ｜单元格03｜单元格04｜

编译成 Html 后的效果会是这样：

｜   表格示例标题   ｜
｜==================｜
｜ 表头01 ｜ 表头02 ｜
｜:-------｜:-------｜
｜单元格01｜单元格02｜
｜单元格03｜单元格04｜

具体情况请参见《[文字表](04-语法与编辑/02-定制语法/01-文字表.html)》。