Markdown 是什么？

Markdown 是目前互联网上最流行的写作语言，它使用一些简单的符号（* / ` > [] () #）来标记文本格式，其简洁的语法、优美的格式以及强大的软件支持深受广大网友的喜爱。

维基百科上对 Markdown 的描述：

" Markdown 是一种轻量级标记语言，创始人是约翰·格鲁伯（John Gruber）。它允许人们 “使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML 文档。”

大家千万不要被一些专业术语唬住了，其实 Markdown 之所以流行，最主要的原因就是因为它的学习门槛很低，你可能只需花几分钟就可以入门了。

Markdown 创始人约翰·格鲁伯（John Gruber）的博客

为什么要用 Markdown？

回想一下我们在写作的时候会遇到什么样的问题？

• 软件不会用：Word 应该是大家写作时最常用的软件，每当打开一个 Word 文档，速度慢先不说，光是复杂繁多的功能就已经足够让你眼花缭乱了，如果你不是专业的编辑，相信绝大部分功能你是用不到的。消除浪费，应该是现代互联网时代大家最先要学会的事情。
• 软件不兼容：这个想必是大家最痛苦的事情，我用的 Word 版本是 2016，你用的是 2003，两人互传资料，一打开格式全乱了。
• 格式不兼容：从网上复制一段文字到 Word 文档中，然后格式全乱了。反之，从 Word 文档中复制一段文字到网上，格式也全乱了，又需要重新调整。
• 排版太费时间：工具通常是这样，提供的功能越多，我们想的也越多，遇到的问题也就会越多。写作时总想着换种字体会不会好看一些，换个颜色试试，行高要不要调整一下，行距是不是太大了，用一下这个功能怎么样等等，时间就是这样一点点被浪费的。罗振宇在 2016 年 “时间的朋友” 跨年演讲中提到过一个观点我非常认同，他说：“当我需要一个服务的时候，不要给我太多选择，请直接告诉我什么是最好的，我要你的最佳方案”。
• 难以团队协作：如果一个项目需要多人共同参与，比如共同翻译一本书，你可能需要版本管理、相互 Review、开放试读、开源、自出版等等，这些使用 Word 是无法满足需求的。也许你说可以使用 Google Doc，但前提是没那么多人会科学上网。

Markdown 如何解决这些问题的呢？

• 语法简单： Markdown 的语法是一些简单而且常用的标记符号，任何人只要花几分钟就能学会；
• 兼容性强： Markdown 是兼容性非常强的纯文本内容，可以使用任何编辑器打开，格式都不会乱；
• 导出方便： Markdown 可以导出 PDF、Word、HTML、Epub、LaTeX 等文件格式；
• 专注内容： 使用 Markdown 写作再也不用纠结排版，其简洁优雅的格式会让你沉浸到写作的乐趣之中；
• 团队协作： Github、Gitlab、Gitbook 都支持 Markdown，团队协作再也不是问题了；

PS：本文节选自 《Markdown 实用指南》

什么时候不合适用 Markdown 呢？

• 需要复杂排版的时候，比如纸版图书编辑就不太适合用 Markdown。我的做法是从 Markdown 导出 Word 文档，然后交给编辑。
• 需要复杂表格的时候，因为 Markdown 对表格的支持太简单了。
• 需要调整图片大小或直接贴本地图片的时候。

Markdown 怎么用？

先熟悉 Markdown 语法，再学会使用 Markdown 工具。请记住，语法是一切的基础，熟悉了语法以后，使用什么工具都可以，好用的工具只是让效率更高而已。

Markdown 语法分为：标准语法和扩展语法。

标准语法适用于所有 Markdown 工具，扩展语法可能每个工具都不一样。

为什么会有扩展语法呢？

由于 Markdown 本身的功能有限，一些特定的需求和场景无法被满足，因此产生了许多第三方的扩展语法。根据不同的需求和场景， Markdown 被扩展了很多功能，比如待办事项（任务列表）、代码高亮。

比较流行的扩展语法是 Github 风格的 Markdown：GitHub Flavored Markdown，毕竟全球最大的程序员『交友』网站。

正是由于 Markdown 第三方扩展语法太多，存在一定程序的碎片化，因此有一些机构和公司试图对 Markdown 语法进行标准化，这个可以参考 CommonMark 。

Markdown相比WYSIWYG编辑器：

优点：

• 因为是纯文本，所以只要支持Markdown的地方都能获得一样的编辑效果，可以让作者摆脱排版的困扰，专心写作。
• 操作简单。比如:WYSIWYG编辑时标记个标题，先选中内容，再点击导航栏的标题按钮，选择几级标题。要三个步骤。而Markdown只需要在标题内容前加#即可

缺点：

• 需要记一些语法(当然，是很简单。五分钟学会)。
• 有些平台不支持Markdown编辑模式。

本站文章短代码

📟文章代码

## 调用站内文章 > 这里主要展示本站的短代码及其用法，基础markdown语法参考下面文章。 [post]2176[/post] `用的时候把 @ 符号删掉` ```html [@post]文章mid[/post] ``` ## 线状标题 [jline]当前线状标题[/jline] `用的时候把 @ 符号删掉` ```html [@jline]当前线状标题[/jline] ``` ## 按钮短代码 [btn href="链接" type="#409eff"]蓝按钮[/btn] [btn href="链接" type....

一、标题

在想要设置为标题的文字前面加#来表示，一个#是一级标题，二个#是二级标题，以此类推，支持六级标题。

注：标准语法一般在#后跟个空格再写文字

示例：

# 这是一级标题

## 这是二级标题

### 这是三级标题

#### 这是四级标题

##### 这是五级标题

###### 这是六级标题

效果如下：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

二、字体

加粗

要加粗的文字左右分别用两个*号包起来

斜体

要倾斜的文字左右分别用一个*号包起来

斜体加粗

要倾斜和加粗的文字左右分别用三个*号包起来

删除线

要加删除线的文字左右分别用两个~~号包起来

示例：

**这是加粗的文字**

*这是倾斜的文字*`

* **这是斜体加粗的文字** *

~~这是加删除线的文字~~

效果如下：

这是加粗的文字

这是倾斜的文字`

*这是斜体加粗的文字*

这是加删除线的文字

三、引用

在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>

n个...

貌似可以一直加下去，但没神马卵用

示例：

>这是引用的内容    
>>这是引用的内容    
>>>>>>>>>>这是引用的内容

效果如下：

这是引用的内容

这是引用的内容

这是引用的内容

四、分割线

三个或者三个以上的 - 或者 * 都可以。

示例：

---
----
***
*****

效果如下：

可以看到，显示效果是一样的。

五、超链接

链接也分行内式和参数式

行内式语法：

[超链接名](超链接地址 "超链接title")
title可加可不加

示例：

[涅槃博客](https://nie.su)

[书苑网文精排社](https://nicepub.top)

效果如下：

涅槃博客

书苑网文精排社

注：Markdown本身语法不支持链接在新页面中打开，貌似简书做了处理，是可以的。别的平台可能就不行了，如果想要在新页面中打开的话可以用html语言的a标签代替。

<a href="超链接地址" target="_blank">超链接名</a>

示例
<a href="https://www.jianshu.com/u/1f5ac0cf6a8b" target="_blank">简书</a>

参数式语法

[博客]: https://nie.su "博客"
[书苑网文精排社]: https://nicepub.top "书苑"
这里是[博客]，这里是[书苑网文精排社]

效果：

这里是博客，这里是书苑网文精排社

这里是[博客]，这里是[书苑网文精排社]

六、列表

无序列表

语法：

无序列表用 - + * 任何一种都可以

- 列表内容
+ 列表内容
* 列表内容

注意：- + * 跟内容之间都要有一个空格

效果如下：

• 列表内容
• 列表内容
• 列表内容

有序列表

语法：

数字+.+空格+内容
1. 列表内容
2. 列表内容
3. 列表内容

注意：序号跟内容之间要有空格

效果如下：

1. 列表内容
2. 列表内容
3. 列表内容

八、表格

语法：

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容。
- 有一个就行，为了对齐，多加了几个
文字默认居左
-两边加：表示文字居中
-右边加：表示文字居右
注：原生的语法两边都要用 | 包起来。此处省略

示例：

| 姓名 | 技能 | 排行 |
| ---- | ---- | ---- |
| 刘备 | 哭   | 大哥 |
| 关羽 | 打   | 二哥 |
| 张飞 | 骂   | 三弟 |

效果如下：

九、代码块

单行代码

单行代码：代码之间分别用一个反引号包起来。

`hello world`

hello world

多行代码

多行代码：代码之间分别用三个反引号包起来，且两边的反引号单独占一行。

<div class="sidebox fixside s_ping" >
<h4 class="sidebox__title">新冠动态</h4>
<i class="bg-primary"></i>
                    <iframe width="100%" frameborder="0" src="https://www.lovestu.com/api/project/cnmapyinqing/obj.php" onload='this.style.height=Math.max(this.contentWindow.document.body.scrollHeight,this.contentWindow.document.documentElement.scrollHeight,200)+"px";'></iframe>

</div>

十、图像

图片分行内式和参数式

![行内式图片](图片链接或路径)

[参数式图片]: 图片链接或路径 //这里是![参数式图片]

效果：

图片居中、宽高和内嵌链接

<center class="half">
    <a href="https://www.starts.sh/"> //内嵌链接
    <img src="图片链接或路径" width="宽" height="高"/>
</center></a>

效果：

十一、其他

字体类型

<font face="微软雅黑">无二自留地</font>

效果：

无二自留地

字体大小

<font face="微软雅黑" size=5>无二自留地</font> //从 1 到 7 的数字,浏览器默认值是 3

效果：

无二自留地

字体颜色

<font face="微软雅黑" color=#FF0000 size=gray>无二自留地</font>

效果：

无二自留地

文本居中

<center><font face="微软雅黑" color=gray size=gray>无二自留地</font></center>

效果：

分段

分段两种方法，空行或者 <p>文本</p> 例：

<p>“假如这里有坚固的高墙和撞墙破碎的鸡蛋，我总是站在鸡蛋一边。—— 村上春树”</p>

空格

文章开头空格两种方法，输入法全角敲两下 space 键，或者文章前输入   例：

<p>&emsp;&emsp;“假如这里有坚固的高墙和撞墙破碎的鸡蛋，我总是站在鸡蛋一边。—— 村上春树”</p>

下划线

给文本添加下划线，例：

<u>“假如这里有坚固的高墙和撞墙破碎的鸡蛋，我总是站在鸡蛋一边。—— 村上春树”</u>

文章截断

博客文章截断

<!--more-->

emoji表情

Markdown语法支持添加emoji表情，输入不同的符号码（两个冒号包围的字符）可以显示出不同的表情。

比如输入:smile:，可以显示 :smile: 表情。

更多表情请点击这个表情库。

Markdown 编辑器推荐

哪些网站支持 Markdown？

简书、知乎、CSDN、Github、Gitlab、Gitbook 全部都支持 Markdown 写作。