markdown语法说明

Markdown是一种用来写作的轻量级『标记语言』,它用简洁的语法代替排版,它使我们能够专心于码字,用『标记』语法来代替常见的排版格式。Markdown的语法简洁明了,学习容易,而且功能比很多纯文本更强,因此很多人用它来写博客。

关于Markdown

Markdown官方文档

更多详细的语法使用可以查看Markdown的官方语法规则文档,本篇文章只是记录了一些个人常用的语法的具体用法:

工具介绍

工欲善其事,必先利其器!支持Markdown的编辑器太多了,功能也不完全一致,有的是用来进行基本写作的,有的是用来写代码的。本博文就介绍下本人用过的一些Markdown编辑器。

  • 马克飞象:实时同步预览,可以同步笔记到印象笔记中,支持导出pdf格式,付费软件,可以免费试用。
  • cmd markdown:实时同步预览,全平台且提供web版。
  • MarkdownPad: 一款全功能的编辑器,被很多人称赞为windows 平台最好用的markdown编辑器。
  • Haroopad:显示效果不错,支持代码高亮,缺点是无法导出pdf文档。
  • Typora:免费极简的Markdown编辑器,合并了书写和预览,所见即所得。

当然也可以使用工作编辑器来打造Markdown编辑器,比如Sublime Text+或者Atom的各种Markdown+Floding+七牛package。

语法说明

标题

标题是写文章最常用的格式之一,在平常的写作当中,我们需要类似如下的操作:输入文本,选中文本,设置标题格式。而在Markdown中,我们只需要在文本前加入#即可。行首插入1-6个 # ,每增加一个 # 表示更深入层次的内容,对应到标题的深度由 1-6 阶,示例如下:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

注:#和文本之间隔一个空格,这是最标准的Markdown写法。

引用

在我们写作的时候经常需要引用他人的文字,这个时候引用这个格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了,例如:

1
>  “文化”可以用四句话表达:植根于内心的修养;无需提醒的自觉;以约束为前提的自由;为别人着想的善良。—— 梁晓声

注:> 和文本之间要保留一个字符的空格。

文本样式

Markdown的粗体和斜体的语法也很简单,Markdown 使用星号(*)和底线(_)作为标记强调字词的符号,具体语法如下(带“*”星号的文本样式,在原版Markdown标准中不存在,但在其大部分衍生标准中被添加):

1
2
3
4
5
**粗体**
__粗体__
*斜体*
_斜体_
*删除线:~~text~~

但是如果你的 \*_两边都有空白的话,它们就只会被当成普通的符号。如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:

1
\*this text is surrounded by literal asterisks\*

分隔线

我们可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

1
2
3
4
5
6
7
8
9
* * *

***

*****

- - -

---------------------------------------

列表

列表格式也是我们常用的格式之一,具体的书写语法如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
- 无序列表项目
- 无序列表项目
- 无序列表项目

* 无序列表项目
* 无序列表项目
* 无序列表项目

1. 有序列表项目
2. 有序列表项目
3. 有序列表项目

- 外层列表项目
+ 内层列表项目
+ 内层列表项目
+ 内层列表项目
- 外层列表项目

注:-、1.和文本之间要保留一个字符的空格。

链接和图片

当我们需要在博文中插入外链,只需要使用 [显示文本](链接地址) 这样的语法即可,例如:

1
2
3
[flwcy's blog](http://flwcy.coding.me/)
[无链接的链接][null-link]
[null-link]: chrome://not-a-link

当我们需要在博文中插入外链,只需要使用![](图片链接地址) 这样的语法即可,例如:

1
![jdbc_start_01](http://o9fozt3s5.bkt.clouddn.com/jdbc_start_01.jpg)

代码

作为一个程序员,我们经常需要在博文中添加示例代码,如果仅仅对一句代码高亮,只需要用`把中间的代码包裹起来:

1
`字符`(简短文字添加代码框)

如果要对整段代码加高亮,则需要在整段代码两端加三个`,示例如下:

1
​```代码块```(代码块)

表格

表格的语法比较麻烦点,具体写法如下:

1
2
3
4
| 一个普通标题 | 一个普通标题 | 一个普通标题 |
| ------| ------ | ------ |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |

效果展示:

一个普通标题一个普通标题一个普通标题
短文本中等文本稍微长一点的文本
稍微长一点的文本短文本中等文本

表格左对齐/右对齐/剧中对齐的语法如下所示:

1
2
3
4
| 左对齐标题 | 右对齐标题 | 居中对齐标题 |
| :------| ------: | :------: |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |

效果展示:

左对齐标题右对齐标题居中对齐标题
短文本中等文本稍微长一点的文本
稍微长一点的文本短文本中等文本

关于表格写法的一些说明:

  • |-:之间的多余空格会被忽略,不影响布局。
  • 默认标题栏居中对齐,内容居左对齐。
  • -:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐。
  • 内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个。

参考文献

文章目录
  1. 1. 关于Markdown
    1. 1.1. Markdown官方文档
    2. 1.2. 工具介绍
  2. 2. 语法说明
    1. 2.1. 标题
    2. 2.2. 引用
    3. 2.3. 文本样式
    4. 2.4. 分隔线
    5. 2.5. 列表
    6. 2.6. 链接和图片
    7. 2.7. 代码
    8. 2.8. 表格
  3. 3. 参考文献
|