Markdown总结

Markdown总结

自从知道markdown，到现在熟练用，感觉markdown简单又好用。不过需要注意的是不同的Markdown实现(或者说渲染器？)，效果也是不同的

标题

#的个数标识标题的级别数。记得要在#和文字之间插入空格，否则有的（比如CSDN不认识哟）

链接

语法

[要显示的文字](链接地址)

语法说明
如上。

引用

语法

>这个是引用 
> 是不是和电子邮件中的 
> 引用格式很像

语法说明
后尖括号开始即可

代码

语法

	```javascript
	```

语法说明

• 代码块：反引号(在esc下方)三个开始，加上语言种类（不加也可，但是加上有高亮显示。也许只有某些编辑器吧），结束也是以三个反引号结束
• 行内代码：代码前后各一个反引号即可
• 在csdn中，制表符有同样功能。

列表

语法

- 文字

语法说明
顶头一个横杠，然后一个空格，然后输入文字。在csdn的markdown编辑器中，列表之前需要一个空行，其它的编辑器不知道是不是

字体

标色

在要标色的文字前后使用==，效果看见我的颜色没。在CSDN可以被识别，所以正常些==时，要在每个=加上转义字符\

中划线

在需要中划线的文字前后使用~(各两个)即可

斜体

在需要使用斜体的文字前后使用*（前后各一个）即可

粗体

在需要使用粗体的文字前后使用**（前后各两个）即可

斜体加粗

在需要使用斜体加粗的文字前后使用***（前后各三个）即可【有的实现不识别这种格式】

表格

语法

Name | Academy | score 
- | :-: | -: 
Harry Potter | Gryffindor| 90 
Hermione Granger | Gryffindor | 100 
Draco Malfoy | Slytherin | 90

说明

• 第一行为表头，第二行分隔表头和主体部分，第三行开始每一行代表一个表格行；
• 列与列之间用管道符号 “|” 隔开，原生方式的表格每一行的两边也要有管道符；
• 可在第二行指定不同列单元格内容的对齐方式，默认为左对齐，在 “-” 右边加上 “:” 为右对齐，在 “-” 两侧同时加上 “:” 为居中对齐；

数学公式

行内公式的边界为$$，前后各一个（因此，在用到$的内容时，需要转义），块级为前后各两个。
上标使用^，下标使用_。当上下标内容超过两位时，需要使用{}

插入图片

插图最基础的格式就是：

![Alt text](图片链接 "optional title")

Alt text：图片的Alt标签，用来描述图片的关键词，可以不写。最初的本意是当图片因为某种原因不能被显示时而出现的替代文字，后来又被用于SEO。 图片链接：可以是图片的本地地址或者是网址。“optional title”：鼠标悬置于图片上会出现的标题文字，可以不写。

插入本地图片

只需要在基础语法的括号中填入图片的位置路径即可，支持绝对路径和相对路径。
例如：

![avatar](/home/picture/1.png)

不灵活不好分享，本地图片的路径更改或丢失都会造成markdown文件调不出图。

插入网络图片

只需要在基础语法的括号中填入图片的网络链接即可，现在已经有很多免费/收费图床和方便传图的小工具可选。
例如：

![avatar](http://baidu.com/pic/doge.png)

将图片存在网络服务器上，非常依赖网络。

把图片存入markdown文件

用base64转码工具把图片转成一段字符串，然后把字符串填到基础格式中链接的那个位置。
基础用法:

![avatar](data:image/png;base64,iVBORw0......)

这个时候会发现插入的这一长串字符串会把整个文章分割开，非常影响编写文章时的体验。如果能够把大段的base64字符串放在文章末尾，然后在文章中通过一个id来调用，文章就不会被分割的这么乱了。
高级用法
比如：

![avatar][base64str]
[base64str]:data:image/png;base64,iVBORw0......

问题

很多问题都是渲染方面的，和Markdown语法无关。在我使用的CSDN、简书、Hugo等，均存在在比较大的差异

行末两个空格

在Hugo编写Markdown文件时，如果行末没有两个空格是不会换行的。

高亮

在Markdown中，==可以用作高亮，但是hugo则不行

代码

在hugo中，三个反引号和代码放一行是不会渲染出代码结构的，除非换行。