Markdown入门

Markdown是一种轻量级标记语言,它的优点在于易于阅读、易于撰写的纯文字格式, 并且可以自由转换成多种格式。目前也被越来越多的写作爱好者,撰稿者广泛使用。

介绍

Markdown旨在尽可能容易阅读和易于写入。

然而,可读性首先被强调。标记格式的文档应该按照原样发布,而不是像标签或格式化说明一样标记。虽然Markdown的语法受到几个现有的文本到HTML过滤器的影响,包括Setext,atx,Textile,reStructuredText, Grutatext和EtText - Markdown语法的最大灵感来源是纯文本电子邮件的格式。

为此,Markdown的语法完全由标点符号组成,标点符号被仔细选择,看起来就像它们的意思。例如,一个字上的星号实际上看起来像强调。标记列表看起来好像列表。

语法:

Markdown作为一种轻量级标记语言,它的语法简洁明了、学习起来容易。

参考:
官方说明
Markdown 中文版语法说明

标题

1
2
3
# 第一级标题
## 第二级标题
###### 第六级标题

效果如下:

第一级标题

第二级标题

第六级标题

强调

1
2
3
4
5
*这些文字会生成*
_这些文字会生成`_

**这些文字会生成**
__这些文字会生成`__

效果如下:

这些文字会生成
这些文字会生成`

这些文字会生成
这些文字会生成`

列表

无序列表

1
2
3
* 列表一
* 列表二
* 列表三

效果:

  • 列表一
  • 列表二
  • 列表三

有序列表

1
2
3
1. 列表一
2. 列表二
3. 列表三

效果如下:

  1. 列表一
  2. 列表二
  3. 列表三

任务列表(Task lists)

1
2
- [ ] 任务一 未做任务
- [x] 任务二 已做任务

效果如下:

  • 任务一 未做任务
  • 任务二 已做任务

图片

1
![图片名称](地址)

链接

1
[名称](链接地址)

区块引用

1
2
某某说:
> balabala

效果:
某某说:

balabala

行内代码

1
`代码`

效果如下:
代码

多行或者一段代码

1
代码段

效果如下:

1
代码段

顺序图或流程图

1
2
3
张三->李四: 嘿,小四儿, 你妈喊你回家吃饭呢!
Note right of 李四: 李四愣了一下,说:
李四-->张三: 哦,知道啦!
1
2
3
4
5
6
7
8
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认?

st->op->cond
cond(yes)->e
cond(no)->op

效果:

1
2
3
张三->李四: 嘿,小四儿, 你妈喊你回家吃饭呢!
Note right of 李四: 李四愣了一下,说:
李四-->张三: 哦,知道啦!

表格

Markdown 语法:

1
2
3
4
表头一 | 表头二
--------- | -------------
第一列第一格 | 格第二列第一格
第一列第二格 | 格第二列第二格

效果如下:

表头一 表头二
第一列第一格 格第二列第一格
第一列第二格 格第二列第二格

删除线

1
~~删除这些~~

效果如下:

删除这些

分隔线

以下三种方式都可以生成分隔线:

1
2
3
4
5
***

*****

- - -

效果如下:




脚注(Footnote)

1
这是一个脚注:[^sample_footnote]

效果如下:

这是一个脚注:^sample_footnote

工具:

常见的Markdown工具有UlyssesMouSublime Text 3等等。

个人比较喜欢mweb,几乎所有的语法都有对应的快捷键,而且还能一键生成&上传至博客。

具体使用方法见官方文档

另外还有一个免费版的