Markdown简明教程

Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。

适用人群

Markdown 是为那些需要经常码字或者进行文字排版的、对码字手速和排版顺畅度有要求的人群设计的。这些人包括经常需要写文档的码农、博客写手、网站小编、出版业人士等等。

推荐软件

Typora: 一款极简的Markdown 编辑器,适用于windows和mac平台。

Markdown 语法规则

标题

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

Markdown 中,如果一段文字被定义为标题,只要在这段文字前加# 号即可。总共六级标题,建议在井号后加一个空格,这是Markdown 标准语法。

列表

Markdown 支持有序列表和无序列表。
无序列表使用星号、加号或是减号作为列表标记:

1
2
3
* a
* b
* c

有序列表则使用数字接着一个英文句点:

1
2
3
1. a
2. b
3. c

注:星号或英文句点后需加一个空格

引用

如果你需要引用一小段别处的句子,那么就要用引用的格式。

例如这样

只需要在文本前加入 >这种尖括号(大于号)即可

1
> 这是引用

插入图片

1
![选填](链接)

详细叙述如下:

  • 一个惊叹号 !
  • 接着一个方括号[],里面放上图片的替代文字
  • 接着一个普通括号(),里面放上图片的网址。

超链接

Markdown支持两种类型的超链接:inlinereference

inline

1
2
[文字](http://example.com/ "标题")
[文字](http://example.com/)

详细叙述如下:

  • 接着一个方括号[],里面放上文字
  • 接着一个普通括号(),里面放上图片的网址。

reference

1
2
3
4
5
6
7
8
9
10
11
[文字][id]

[id]: http://example.com/ "可选标题"

### 粗体和斜体

用两个`*`包含一段文本就是粗体的语法,用一个 `*` 包含一段文本就是斜体的语法

```markdown
**A** #这是粗体
*B* #这是斜体

表格

Markdown 的表格功能比较难用,Typora提供了像 Office 一样的表格编辑能力。通过菜单栏或快捷键可以插入表格,Typora 会弹出一个表格插入设置,你可以预先设定好行数和列数。

示例:

1
2
3
4
5
| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is | some wordy text | $1600 |
| col 2 is | centered | $12 |
| zebra stripes | are neat | $1 |

效果:

Left-Aligned Center Aligned Right Aligned
col 3 is some wordy text $1600
col 2 is centered $12
zebra stripes are neat $1

任务列表

任务列表项目标记为[]或[ X] (未完成或完全)。
示例:

1
2
3
4
5
- [ ] a
- [ ] b
- [ ] c
- [ ] d
- [x] e

效果:

  • [ ] a
  • [ ] b
  • [ ] c
  • [ ] d
  • [x] e

你可以点击复选框修改任务状态

注脚

1
2
3
你可以创建一个像这样注脚[^1].

[^1]: 这是注脚的内容.

效果:

你可以创建一个像这样的注脚^1.

鼠标放在注脚上,可以看到注脚的内容.

代码

  1. 代码框:
    用两个反引号 ` 把中间的代码包裹起来,如

    1
    `code`
  2. 代码区域:
    2.1 缩进 4 个空格或是 1 个制表符(Tab键)

    1
    code

    2.2 反引号:

    1
    2
    3
    4
    5
    ‘’‘ruby
    require 'redcarpet'
    markdown = Redcarpet.new("Hello World!")
    puts markdown.to_html
    '''

目录 (TOC)

输入[ TOC ],然后按回车键将创建“目录”,从文章提取所有标题,目录会自动更新。

网址

<http://example.com/>

删除线

~~示例~~
示例

分割线

另起一行,连续输入三个星号***

进阶技巧

首行缩进

在段首加入&ensp;来输入一个半方空格.加入&emsp;来输入一个全方空格
示例

&emsp;&emsp;一语未了,只听后院中有人笑声,说:“我来迟了,不曾迎接远客!"

  一语未了,只听后院中有人笑声,说:“我来迟了,不曾迎接远客!”

图片居中(html语法)

1
<div align=center> <img src="link" width="400" height="400" alt="test"/> </div>

下划线(HTML语法)

<u>下划线</u>
下划线.

文字颜色(html语法)

1
<font color="white">文字<font>

Markdown 免费编辑器

Windows 平台

Linux 平台

Mac 平台

在线编辑器

浏览器插件

参考链接

文章目录
  1. 1. 适用人群
  2. 2. 推荐软件
  3. 3. Markdown 语法规则
    1. 3.1. 标题
    2. 3.2. 列表
    3. 3.3. 引用
    4. 3.4. 插入图片
    5. 3.5. 超链接
      1. 3.5.1. inline
      2. 3.5.2. reference
    6. 3.6. 表格
    7. 3.7. 任务列表
    8. 3.8. 注脚
    9. 3.9. 代码
    10. 3.10. 目录 (TOC)
    11. 3.11. 网址
    12. 3.12. 删除线
    13. 3.13. 分割线
  4. 4. 进阶技巧
    1. 4.1. 首行缩进
    2. 4.2. 图片居中(html语法)
    3. 4.3. 下划线(HTML语法)
    4. 4.4. 文字颜色(html语法)
  5. 5. Markdown 免费编辑器
  6. 6. 参考链接
,