概述
设计理念
Markdown 视可读性为最高准则.
Markdown 完全由标点符号组成, 这些标点经过仔细挑选以使他们看上去和表达的含义相同.
内联 HTML
- Markdown 是用于 创作 web 文档的.
- Markdown 的目标是易于阅读, 创作和编辑文章. HTML 是一种 **发布 **格式; Markdown 是一种 创作 格式. 因此, Markdown 处理的都是纯文本.
- Markdown可以直接使用HTML标签。例:添加HTML表格到Markdown文件
- 唯一的限制就是对于 HTML 块级元素 -- 像
<div>
,<table>
,<pre>
,<p>
, 等等. -- 必须另起一行单独放 , 并且开始和结束标签前面不能有任何缩进. - 例:添加HTML表格到Markdown文件
This is a regular paragraph.
<table>
<tr>
<td>Foo</td>
<td>Foo</td>
<td>Foo</td>
</tr>
<tr>
<td>Foo</td>
<td>Foo</td>
<td>Foo</td>
</tr>
</table>
This is another regular paragraph.
Markdown语法在HTML里并不会生效.
HTML 内联元素 -- 例如
<span>
,<cite>
, 和<del>
-- 可以在 Markdown 段落, 列表项, 标题中任意使用. 甚至可以使用 HTML 标签替代 Markdown 格式; 例如可以用 HTML<a>
和<img>
标签替代 Markdown 的链接和图片语法.不同于 HTML 块级元素, Markdown 语法可以 在内联元素中解析.
特殊字符自动转义
在 HTML 中, 有两个字符需要特殊对待:
<
和&
. 左尖括号用于起始标签; 英镑符号用于表示 HTML 字符实体. 如果想将它们用作字面量, 则必须将它们转义为字符实体, 例如<
和&
.-
对于
&
符号,使用它时,Markdown不会转义:- ©
-
不使用&符号时,例如在URL中,或如下所示,
&
符号会自动转换为&
:- AT&T
由于 Markdown 支持 内联 HTML, 如果使用尖括号作为 HTML 标签定界符, Markdown 将不会进行转义.
是如果写:4 < 5,Markdown 会将其转义:4
<
5.总而言之, Markdown 的块级元素和内联元素中, 尖括号和英镑符号总是被自动编码.