如何使用 Markdown 书写博客

• Markdown 是什么？

Markdown是一种轻量级标记语言，你能够简单地理解为HTML的简化版，Markdown简单的语法使阅读和创做文档变得容易。由于语法特别简单并且容易排版，Markdown常常被用来书写我的博客。

Markdown简单易学，语法点不多，基本上一个小时就能够学完。下面将会具体介绍Markdown的基本语法，学会这些，你也能够本身写一篇排版优美的博客了！

---

• 基础语法

与HTML同样，Markdown也有本身的文件格式，已md结尾，如：test.md

---

• 标题

Markdown标题语法很是简单，只要在文本前面加#号便可，以下：

# 标题1
## 标题2
### 标题3
#### 标题4
##### 标题5
复制代码

效果以下：

标题1

标题2

标题3

标题4

标题5

• 引述

---

在Markdown中使用引述，只需在引用文本前加“>”就好了：

> 这是一个引述
>> 嵌套引述
复制代码

效果：

这是一个引述

嵌套引述

• 字体格式

---

Markdown中，使用_文本_的格式来斜体文本，使用__文本__的格式来加粗文本，具体以下(注: _均可以使用*来代替 , 就看你的我的喜爱了):

_斜体_

**加粗**

___斜体加粗___

复制代码

斜体

加粗

斜体加粗

• 列表

列表语法中,如下符合是等效的: * , - , +

看我的喜爱咯.

代码:

- 一
- 二
- 三
 -- 二级列表
复制代码

效果:

• 一
• 二
• 三
  • 二级列表

有序列表:

1. 一
2. 二
3. 三
4. 四
 - 能够搭配无序列表
 - 4.1
 - 4.2
复制代码

效果:

1. 一
2. 二
3. 三
4. 四
   • 能够搭配无序列表
   • 4.1
   • 4.2

• 连接

Markdown连接有三种格式:

1. 行内式： 格式为 [link text](URL 'title text')。

代码：

[百度一下,你就知道](http://www.baidu.com/)
复制代码

效果：

百度一下,你就知道

2. 参考式（推荐）：

参考式连接的写法至关于行内式拆分红两部分，并经过一个识别符来链接两部分。参考式能尽可能保持文章结构的简单，也方便统一管理URL。

我的推荐使用参考式，这样咱们能够把URL放在文件开头处，便于修改和管理，参考式相对于行内式有一个明显的优势，就是能够在多个不一样的位置引用同一个URL。示例代码以下：

首先，定义连接(两个都是方括号)： 第二个方括号内为连接独有的识别符，能够是字母，数字，空白，注意其不区分大小写。

[百度][link]
空白形式：
[百度][]
复制代码

效果：

百度

空白形式：

百度

定义连接内容： 其格式为：[识别符]: URL “title”。 示例代码以下：

[link]: http://www.baidu.com/ "百度"
空白形式：
[百度]: http://www.baidu.com/ "百度"
复制代码

title 可写可不写， 我通常是先把连接定义在文件开头，而后再在文章内引用。

3. 直接式

这种形式适合来书写邮箱和引用连接，格式为<URL> 代码：

<www.baidu.com>

<www.example@email.com>
复制代码

效果：

<www.baidu.com>

www.example@email.com

---

• 图片

Markdown中引用图片格式以下：

插入图片的语法和插入超连接的语法基本一致，只是在最前面多一个!。也分为行内式和参考式两种。

格式为 。同样的，title text内容可写可不写。示例代码：

1. 行内式：

![GitHub](https://user-gold-cdn.xitu.io/2019/2/16/168f4f17755344a8?w=100&h=100&f=jpeg&s=2170 "GitHub,Social Coding")
复制代码

效果：

GitHub,Social Coding

2. 参考式（推荐）：

![GitHub][github]

[github]: https://user-gold-cdn.xitu.io/2019/2/16/168f4f17755344a8?w=100&h=100&f=jpeg&s=2170 "GitHub,Social Coding"
复制代码

效果：

---

• 代码块

Markdown中代码块格式以下： 示例：

```python
import os
print("Hello")
```

三个```要独占一行, ```后写上所写的语言名，就可使用相应语言的语法高亮。 效果：

import os
print("Hello")
复制代码

• 表格

Markdown中搭建表格很是简单，语法以下：

使用 | 来分隔不一样的单元格，使用 - 来分隔表头和其余行

示例代码：

name | age
---- | ---
LearnShare | 12
Mike |  32
复制代码

更加美观的写法：

|    name    | age |
| ---------- | --- |
| LearnShare |  12 |
| Mike       |  32 |
复制代码

效果：

name	age
LearnShare	12
Mike	32

对齐： 在表头下方的分隔线标记中加入 :，便可标记下方单元格内容的对齐方式：
:--- 表明左对齐
:--: 表明居中对齐
---: 表明右对齐

代码：

| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a    | b      | c     |
复制代码

效果：

left	center	right
aaaa	bbbbbb	ccccc
a	b	c

---

• 目录索引

对一篇长的文章来讲，一个带位置定位的目录是很重要的，幸运的是，在Markdown中实现并不难，具体语法与连接类似：
[标题](#要引用的标题内容) 注：标题内容不区分大小写 示例：

## section
- [test](#test)
复制代码

如上，就能够定位到test标题的位置了。
效果：（简书或者其余一些博客网站貌似不支持页面内目录跳转，这里就不演示了）

section

• test

---

• 扩展

1.分隔线

Markdown中,能够在一行中使用三个或更多的 *、- 或 _ 来添加分隔线 要注意与文本之间要有空行:

---
复制代码

效果:

---

2.删除线

Markdown使用~~来做为删除线，使用方法以下： 代码：

这是 ~~要删除的文本~~
复制代码

效果：
这是 要删除的文本

3.字符转义

反斜线（\）用于插入在 Markdown 语法中有特殊做用的字符。 例如：

这是用来 *演示* 的 _文本_
这是用来 \*演示\* 的 \_文本\_
复制代码

效果：
这是用来 演示 的 文本
这是用来 *演示* 的 _文本_

---

写在最后

以上，就是Markdown的基本语法了，这些东西熟练掌握后，写几篇我的博客就彻底是手到擒来了。

虽然简单，仍是要写几篇博客来练习加深记忆，写博客的过程就是学习的过程，无论你写的是什么，哈哈，这是一位大佬跟我说的。这也是个人第一篇博客，接下来我也但愿本身能坚持并养成写博客的这个习惯。

若是看完了，就赶忙去写你本身的一篇博客吧！

参考

• Learning-Markdown
• Introduction To Markdown Using Visual Studio Code