Markdown 语法说明

1. Markdown是什么?

Markdown是一种轻量级标记语言,它以纯文本形式(易读、易写、易更改)编写文档,并最终以HTML格式发布。
Markdown也可以理解为将以MARKDOWN语法编写的语言转换成HTML内容的工具。

2. 谁创造了它?

它由Aaron SwartzJohn Gruber共同设计,Aaron Swartz于2013年***去世。维基百科对他的介绍是:软件工程师、作家、***组织者、互联网活动家、维基百科人

简单介绍一下这位天才,短暂而开挂的一生:

  • 14岁参与RSS 1.0规格标准的制订。
  • 2004年入读斯坦福,之后退学。
  • 2005年创建Infogami,之后与Reddit合并成为其合伙人。
  • 2010年创立求进会(Demand Progress),积极参与禁止网络盗版法案(SOPA)活动,最终该提案被撤回。
  • 2011年7月19日,因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
  • 2013年1月***身亡。

3. 为什么要使用它?

  • 它是易读(看起来舒服)、易写(语法简单)、易更改纯文本。处处体现着极简***的影子。
  • 兼容HTML,可以转换为HTML格式发布。
  • 跨平台使用。
  • 越来越多的网站支持Markdown。
  • 更方便清晰地组织你的电子邮件。(Markdown-here, Airmail)
  • 摆脱Word

4. 怎么使用?

Markdown的语法绝对简单到让你爱不释手。

Markdown语法主要分为如下几大部分:标题强调代码列表段落区块引用分割线链接图片数学公式反斜杠 \

4.1 标题

这是最为常用的格式,在平时常用的的文本编辑器中大多是这样实现的:输入文本、选中文本、设置标题格式。

而在 Markdown 中,你只需要在文本前面加上 # 即可,同理、你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。例如:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题 

注:# 和「一级标题」之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

一级标题

二级标题

三级标题

4.2 强调

在强调内容两侧分别加上*或者_,如:

*斜体*,_斜体_
**粗体**,__粗体__

效果:

斜体斜体
粗体粗体

4.3 列表

列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 - 就可以了,例如:

- 文本1
- 文本2
- 文本3

如果你希望有序列表,
也可以在文字前面加上 1. 2. 3. 就可以了,例如:

1. 文本1
2. 文本2
3. 文本3

注:-1.和文本之间要保留一个字符的空格。

4.4 代码

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

单行代码

效果: create database hero;

代码区块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

代码区块

效果:

void main()
{
    printf("Hello, Markdown.");
}

4.5 段落

段落的前后要有空行,所谓的空行是指没有文字内容。

4.6 分割线

分割线最常使用就是三个或以上*,还可以使用-_

4.7 链接

链接可以由两种形式生成:行内式参考式
行内式

[Markdown使用说明](https://www.nowcoder.com/discuss/179680 "Markdown")

效果:

Markdown使用说明

参考式

[Markdown使用说明1][1]
[Markdown使用说明2][2]
[1]:https://www.nowcoder.com/discuss/179680 "Markdown"
[2]:https://www.nowcoder.com/discuss/179680 "Markdown"

效果:

Markdown使用说明1
Markdown使用说明2

注意:上述的[1]: https://www.nowcoder.com/discuss/179680 "Markdown"不出现在区块中。

4.8 图片

添加图片的形式和链接相似,只需在链接的基础上前方加一个

4.9 数学公式

我们的Markdown语法还支持LaTeX数学公式,这属于相当高阶的应用

公式源码:

$O(\displaystyle{\frac{n^2}{S}}+m \times S)$

效果:

公式源码:

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$

效果:

4.10 表格

还可以制作表格,例如:

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

显示效果:

dog bird cat
foo foo foo
bar bar bar
baz baz baz

|表示表格纵向边界,表头和表内容用-隔开,并可用:进行对齐设置,两边都有:则表示居中,若不加:则默认左对齐。
比如:

| Tables        | Are           | Cool  |
| :------------ |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

显示效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

4.11 反斜杠\

相当于反转义作用。使符号成为普通符号。

5. 结语

以上几种格式是我们网站用户较为常用的语法,所以我们针对这些语法做了比较详细的说明。

强烈建议您现在就立马用 Markdown 写一篇文章吧,体会一下 Markdown 的优雅之处!

#Uber#
全部评论
谢谢爸爸
3 回复 分享
发布于 2019-08-06 10:14
希望支持一些扩展语法,比如: ==高亮== ~~下标~~ ^上标^ 这样从typora或云笔记导入过来的时候不用修改了
2 回复 分享
发布于 2020-02-04 18:22
输入代码块后,可以选择编程语言(Typora)。谢谢。
1 回复 分享
发布于 2020-07-06 11:03
有没有快捷键!!!!!
1 回复 分享
发布于 2022-06-06 21:36
大家有什么关于markdown的问题,也可以在下方留言~~~
点赞 回复 分享
发布于 2019-04-17 17:28
点赞 回复 分享
发布于 2019-08-06 10:17
关于图片的居中排版和一些css样式站内支持吗
点赞 回复 分享
发布于 2019-08-09 20:08
请问Markdown可以控制文字缩进吗?比如首行缩进两个字符。
点赞 回复 分享
发布于 2019-08-13 22:01
请支持流程图
点赞 回复 分享
发布于 2019-10-03 09:48
什么时候能像CSDN一样支持生成目录啊
点赞 回复 分享
发布于 2019-11-09 20:29
我只想给文本换颜色55555~
点赞 回复 分享
发布于 2020-02-11 11:41
大佬,为什么不能用多行公式的代码啊。。。
点赞 回复 分享
发布于 2020-06-07 17:41
图片可以修改大小么? 本来很小的一个图片硬是放得很大
点赞 回复 分享
发布于 2020-11-15 16:05
点赞 回复 分享
发布于 2020-11-16 15:56
文章目录怎么加
点赞 回复 分享
发布于 2022-03-29 09:59
希望能增加表情功能🤔
点赞 回复 分享
发布于 2022-04-16 11:26
支持自定义css格式吗?
点赞 回复 分享
发布于 2022-05-13 07:37
牛客markdown的 “混合代码”功能是不是有问题?发布效果和预览效果不一致
点赞 回复 分享
发布于 10-03 20:49 江苏

相关推荐

14 22 评论
分享
牛客网
牛客企业服务