Skip to main content

Markdown入门教程

什么是Markdown？​

百度百科

为什么要使用Markdown？​

Markdown能够使我们专注于写作本身，而不是把很多精力放在如何排版、设置字体大小、设置文本间距等等..等等这些事情上。

如何开始使用Markdown？​

Markdown本身只是一种标记语言，具体的使用是通过专门的Markdown编辑器，编辑器类型主要分为三种：

  • 在线编辑器
    • Dillinger 官网推荐，来自国外，访问可能不稳定
    • MaHua 小众软件
  • 独立编辑器
  • 开发工具扩展插件

关于编辑器，此处只是举例，并不做推荐，总体来说，OSX平台下编辑器质量较好。

基本使用方法​

在日常写作的时候，一篇文章的元素主要包括标题、段落、分隔符、引用等，文字的效果主要包括粗体和斜体，下面就逐一来说明Markdown是如何来实现这些不同的元素。

标题​

在Markdown中，通过在名称前添加#号标志来创建标题，#号的数量对应着标题的级别，例如1个#号表示一级标题，3个#号表示三级标题。

Markdown渲染效果
# 一级标题

一级标题

## 二级标题

二级标题

### 三级标题

三级标题

#### 四级标题

四级标题

##### 五级标题
五级标题
###### 六级标题
六级标题

段落​

段落之间的区分是通过1个或者多个空行实现。

Markdown渲染效果

我喜欢使用Markdown。

我打算使用Markdown格式化所有的文档。

我喜欢使用Markdown。

我打算使用Markdown格式化所有的文档。

分隔符​

Markdown渲染效果
*** 或者 ---

引用​

在需要引用的文本前添加>符号即可。

Markdown渲染效果
> 我们坚信写作写的是内容，所思所想，而不是花样格式。
我们坚信写作写的是内容，所思所想，而不是花样格式。

列表项​

有序列表​

Markdown渲染效果
1. 第一项
2. 第二项
3. 第三项
4. 第四项		1. 第一项
2. 第二项
3. 第三项
4. 第四项

无序列表​

Markdown渲染效果
* 第一项
* 第二项
* 第三项
* 第四项		• 第一项
• 第二项
• 第三项
• 第四项

文字强调​

粗体​

Markdown渲染效果
***粗体*** 效果 粗体 效果

斜体​

Markdown渲染效果
*斜体* 效果 斜体 效果

链接​

链接的标题使用中括号包裹，链接的 URL 使用小括号，例如：

我的博客是 [王恩永的博客](https://enyong.wang)

渲染后的效果如下：

我的博客是 王恩永的博客。

URLs和电子邮箱地址​

URLs和电子邮箱地址可快速生成链接：

<https://www.markdownguide.org>
<fake@example.com>

https://www.markdownguide.org fake@example.com

图片​

插入图片和链接十分相似，只是在中括号前增加一个感叹号!:

![tux](https://ocrtest-1253817761.cos.ap-guangzhou.myqcloud.com/blog/introduction%20to%20markdown/tux.png)

tux

代码​

如果只是声明一个单词或者词组为代码，使用 (`)。

Markdown渲染效果
At the command prompt, type `vim`. At the command prompt, type vim.

代码块​

如果是声明代码块，则使用 (```) 标记，紧跟着后面还可以通过输入不同的语言类型来选择不同的代码高亮风格。

```html
<html>
  <head>
  </head>
</html>
生成的代码块如下：

​```html
<html>
  <head>
  </head>
</html>

结语​

以上仅仅归纳了Markdown最基本的使用方法，但已经能够满足很多的写作场景，后续会继续对进阶的使用进行归纳总结，谢谢。