Markdown 是我很喜欢的一个轻量级标记语言,但也因为不常写,所以有些语法记得不是很清楚,经常写的时候需要查一些资料,所以这次就把一些简单的常用的语法做个笔记。

在介绍 markdown 语法之前,先写一点废话。

一. markdown是什么?

简单的一句话就是,Markdown 可谓是程序员必备的一种写作格式!你还在用 word 写文档么?简直 low 爆了,赶紧抛弃,从现在开始,立刻,马上,学习下 markdown。

二. markdown有什么好处?

简单说,语法简单、再也不用专注排版、兼容 html、还有其他的的很多很强大的功能(这么厉害,你的博客为啥不用?因为 WordPress 原生编辑器不支持 markdown,也一直没有安装第三方的插件,所以就没有)

三. markdown 编辑器有哪些?

个人最喜欢的开发工具是,GitHub 出品的 Atom,自带提示;之前也在 Windows 下用过 markdownpad,也还行,mac 下有很多人推荐 mou,另外据说 Sublime 也不错,还有一些在线工具据说也不错。

四. markdown 语法

  1. 标题 1 到 6:#1 到 #6

代码示例:


\# 标题一  
\### 标题三
  1. 区块:>

代码示例:


> 这是区块  
>  
> 第二行区块
  1. 斜体:*斜体*

代码示例:


\*斜体\*
  1. 加粗:**加粗**

代码示例:


\*\*该部分加粗\*\*
  1. 删除线:删除线

示例代码:


~~这是加删除线的文字~~
  1. 换行和分段

换行:只需在行末加两个空格键和一个回车键即可换行。快捷键:control + 回车键
分段:段落之间空一行即可

  1. 无序列表:*、+、-

代码示例:


* 第一个  
* 第二个

多一行

* 第三个  
+ 嵌套一  
+ 嵌套二
  1. 有序列表:数字 + 点号

代码示例:


1. 第一个  
1. 第二个

注:

  1. 如果段的开头就是数字 + 点号,则在点号之前加 \ 进行转义;

  2. 如果想在列表的单项内使用代码,则代码之前必须是 2个 Tab 或者 8个空格 ;

  3. 如果想在列表的单项内使用区块,则>之前必须是 1个 Tab 或者 4 个空格, 并且前后各一个空行;

  4. 代码块:

示例代码:三个上分点


“\`java

这是代码

“\`
  1. 行内代码:

示例代码:


来个\`HelloWorld\`吧
  1. 行内链接

示例代码:


这是\[BridgeLi’s Blog\](https://www.bridgeli.cn "BridgeLi’s Blog")。
  1. 参考链接

示例代码:


这是\[BridgeLi’s Blog\]\[1\]。  
[1]: https://www.bridgeli.cn "BridgeLi’s Blog"
  1. 自动链接

示例代码:


<https://www.bridgeli.cn>
  1. 图片,图片和链接一样

示例代码:


下面是 BridgeLi 的头像:

!\[BridgeLi\](https://secure.gravatar.com/avatar/1f76f8c0aac21a192a62378cdff08996?s=96&d=mm&r=g "BridgeLi")
  1. 分割线:三个以上的*、-、_

示例代码:


\****  
&#8212;-  
____
  1. 表格

示例代码:


表头|表头|表头  
&#8212;|:&#8211;:|&#8212;:  
内容|内容|内容  
内容|内容|内容

第二行分割表头和内容。  
&#8211; 有一个就行,为了对齐,多加了几个  
文字默认居左  
-两边加:表示文字居中  
-右边加:表示文字居右  
注:原生的语法两边都要用 | 包起来。此处省略
  1. 代办列表: 表示列表是否勾选状态(注意:[ ] 前后都要有空格)

示例代码:


&#8211; [ ] 不勾选  
&#8211; [x] 勾选
  1. 流程图,来个简单的,实际上 md 支持:流程图、时序图和甘特图

示例代码:


&#8220;\`graph  
graph TD;  
A&#8211;>B;  
A&#8211;>C;  
B&#8211;>D;  
C&#8211;>E;  
E&#8211;>F;  
D&#8211;>F;  
F&#8211;>G;  
&#8220;\`

最后说一点点八卦,之前看耗子叔的文章,markdown 是 Aaron Swartz 十几岁的时候开发的,一个称之无愧的天才,具体怎么天才可以参看耗子叔的文章,写的非常好。

参考链接:

  1. https://www.diguage.com/archives/28.html
  2. https://github.com/riku/Markdown-Syntax-CN