本文最后更新于 2031 天前,其中的信息可能已经有所发展或是发生改变。
超链接
行内式
格式为 [link text](URL 'title text')
。
① 普通链接:
[Google](http://www.google.com/)
② 指向本地文件的链接:
[icon.png](./images/icon.png)
③ 包含 'title' 的链接:
[Google](http://www.google.com/ "Google")
title 使用 ' 或 " 都是可以的。
参考式
参考式链接的写法相当于行内式拆分成两部分,并通过一个 识别符 来连接两部分。参考式能尽量保持文章结构的简单,也方便统一管理 URL。
① 首先,定义链接:
[Google][link]
第二个方括号内为链接独有的 识别符,可以是字母、数字、空白或标点符号。识别符是 不区分大小写 的;
② 然后定义链接内容:
[link]: http://www.google.com/ "Google"
其格式为:[识别符]: URL 'title'
。
其中,URL可以使用 <> 包括起来,title 可以使用 ""、''、() 包括(考虑到兼容性,建议使用引号),title 部分也可以换行来写;
链接内容的定义可以放在同一个文件的 任意位置;
③ 也可以省略 识别符,使用链接文本作为 识别符:
[Google][]
[Google]: http://www.google.com/ "Google"
参考式相对于行内式有一个明显的优点,就是可以在多个不同的位置引用同一个 URL。
自动链接
使用 <>
包括的 URL 或邮箱地址会被自动转换为超链接:
<http://www.google.com/>
<123@email.com>
该方式适合行内较短的链接,会使用 URL 作为链接文字。邮箱地址会自动编码,以逃避抓取机器人。
表格
单元格和表头
使用 |
来分隔不同的单元格,使用 -
来分隔表头和其他行:
name | age
---- | ---
LearnShare | 12
Mike | 32
name | age |
---|---|
LearnShare | 12 |
Mike | 32 |
为了美观,可以使用空格对齐不同行的单元格,并在左右两侧都使用 |
来标记单元格边界:
| name | age |
| ---------- | --- |
| LearnShare | 12 |
| Mike | 32 |
name | age |
---|---|
LearnShare | 12 |
Mike | 32 |
为了使 Markdown 更清晰,
|
和-
两侧需要至少有一个空格(最左侧和最右侧的|
外就不需要了)。
对齐
在表头下方的分隔线标记中加入 :
,即可标记下方单元格内容的对齐方式:
-
:---
代表左对齐 -
:--:
代表居中对齐 -
---:
代表右对齐
| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a | b | c |
left | center | right |
---|---|---|
aaaa | bbbbbb | ccccc |
a | b | c |
如果不使用对齐标记,单元格中的内容默认左对齐;表头单元格中的内容会一直居中对齐(不同的实现可能会有不同表现)。
插入其他内容
表格中可以插入其他 Markdown 中的行内标记:
| name | age | blog |
| ------------ | --- | ------------------------------- |
| _LearnShare_ | 12 | [Blog](http://xiaodongxier.com) |
| __Mike__ | 32 | [note](http://xiaodongxier.com) |
name | age | blog |
---|---|---|
LearnShare | 12 | Blog |
Mike | 32 | Mike |