宗旨
Markdown的目标:实现「易读易写」
兼容HTML
Markdown 语法的目标是:成为一种适用于网络的书写语言
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
要制约的只有一些 HTML 区块元素――比如 <div>
、 <table>
、<pre>
、 <p>
等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能,不会在 HTML 区块标签外加上不必要的 <p>
标签。例如:
<table>
<tr>
<td>Foo</td>
</tr>
</table>
上述代码展示如下:
Foo |
请注意,在 HTML 区块标签间的 Markdown 格式语法将不会被处理。比如,你在 HTML 区块内使用 Markdown 样式的
*强调*
会没有效果。
这解释了为什么需要对一些块级元素进行制约,是为了防止Markdown无法判断HTML的结束位置。
同时,因为这项规定,依照个人习惯,甚至可以不用 Markdown 格式,而直接采用 HTML区块标签来格式化。
这是注意上述讲的都是HTML区块标签,而Markdown 语法在 HTML 区段标签间是有效的。
特殊字符自动转换
Markdown 让你可以自然地书写字符,需要转换的由它来处理好了。
你如果要在文档中插入一个符号&,你可以这样写:&
你如果要在文档中插入一个版权符号 ©,你可以这样写:©
你如果要在文档中插入一个符号<,你可以这样写:<
还有其他特殊字符也会被转换,这里不一一讲解。
简明语法介绍
标题
在Markdown中,标题总共有六级,在文本前面加上n个#(1<=n<=6),就生成几级标签。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
预览效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
锚点
Coding 会针对每个标题,在解析时都会添加锚点id,如
# 锚点
会被解析成
<h1 id="user-content-锚点">锚点</h1>
注意我们添加了一个user-content-的前缀所以如果要自己添加跳转链接要使用markdown的形式,且链接要加一个’user-content-‘前缀,如:
[问内链接](#user-content-锚点);
页面会出现一个“问内连接”的跳转链接,如果点击改链接,会跳到id为user-content-锚点的位置。