Markdown常用基本语法

Markdown概述

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,在 2004 由约翰·格鲁伯(英语:John Gruber)创建。Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。Markdown 编写的文档后缀为 .md, .markdown。Markdown 能被使用来撰写电子书,如:Gitbook。此外,当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

标题

在 Markdown 中,在文本前面加上 # 即为标题。同理,你还可以增加二级标题、三级标题、四级标题、五级标题和六级标题,总共六级,只需要增加 # 即可,标题字号相应降低。
注:# 和标题之间建议保留一个字符的空格,这是最标准的 Markdown 写法。

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

显示为:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

还有第二种表示标题的方式,使用=和-作为标记(三个以上),比如:

一级标题
===
二级标题
---

显示为:

一级标题

二级标题

列表

列表则是在文字前面加上-/+/*的一种就可以了,符号和后面内容间加个空格,此外列表也可以嵌套(在最前面加上三个空格即可),比如:

#无序列表
- 叙述一
   1. 分段一
   2. 分段二
   3. 分段三
+ 叙述二
* 叙述三
#有序列表
1. 叙述一
   + 分段一
2. 叙述二
3. 叙述三

显示为:

  • 叙述一
    1. 分段一
    2. 分段二
    3. 分段三
  • 叙述二
  • 叙述三
  1. 叙述一
    • 分段一
  2. 叙述二
  3. 叙述三

链接和图片

Markdown中插入链接只需要使用[标记文本](链接地址) "链接名称"即可,其中链接名称可省略比如:
[百度](www.baidu.com)
显示为:
百度
图片与链接类似,使用![图片名](图片链接地址 "图片名")即可,其中地址后的图片名指鼠标悬停时显示的图片名,可以省略。插入图片的地址需要图床,想了解的可以参考markdown图床。可以按下面的方式插入图片:
![贾宝玉和林黛玉](https://upload-images.jianshu.io/upload_images/16691637-74e1cd2cb25327df.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
显示为:

贾宝玉和林黛玉

此外可以使用变量代替链接的地址,转而在文档末尾变量赋值作为地址,比如

我们用变量baidu代替地址的值,[百度][baidu]
也可以用变量1代替谷歌的地址,[谷歌][1]
[baidu]: http://www.baidu.com/
[1]: http://www.google.com

简书貌似不支持显示,这里就不做演示了

引用

在文章中引用别人的文字或者想要特别显示的文字,就可以使用> 文字来插入引用,并且引用可以嵌套>> 文字,利用嵌套可以实现一定的格式控制。此外,可以在列表中使用引用(>前面要有四个空格)或者在引用中使用列表。比如:

>这世上本没有路,走的人多了便成了路
>
>静夜思
>>床前明月光,
>>疑是地上霜。
-列表中使用引用
    >前面需要有四个空格
    >前面需要有四个空格
>>
>引用中的列表
>1. 第一条
>2. 第二条
>- 列表内容
>
列表中带有引用
1. 第一条
    >前面要有四个空格
2. 第二条

显示为:

这世上本没有路,走的人多了便成了路

静夜思

床前明月光,
疑是地上霜。

引用中的列表

  1. 第一条
  2. 第二条
  • 列表内容

列表中带有引用

  1. 第一条

    前面要有四个空格

  2. 第二条

字体设置

在Markdown中设置字体也很简单,使用*_隔开要修改字体的文字即可,显示斜体使用*文字*_文字_(一个*_),粗体使用**文字**或者__文字__(两个*_),粗体倾斜使用***文字***___文字___(三个*_),删除字体使用~~文字~~,下划线则要使用HTML中的<u>标签,脚注使用[^标注文字]来添加比如:

这是一段文字,*这是斜体*,而**这是粗体**,***斜体加粗***,~~删除我吧~~。
这是一段脚注[^脚注]
[^脚注]:  这是一段脚注

显示为:
这是一段文字,这是斜体,而这是粗体斜体加粗删除我吧
这是一段脚注[1]

插入代码块

需要插入代码块进行引用时,可以使用`扩起单行,使用```扩起多行(```放于首行和尾行),并且可以指定使用的语言(也可以不指定),也可以在每行代码之前加四个空格或一个tab键(简书好像不行,可能需要设置tab键等于四个空格)。当代码块内需要加入反引号时,只需最外层的单引号比内层的多就可以了。比如:
`单行引用`显示为这是单行引用

``` python(指定语言)
print("hello world!")
print("你好,世界!")
```
  print("hello world!")

显示为:

print("hello world!")
print("你好,世界!")
print("hello world!")

在反引号内插入反引号(嵌套)

````
`print("hello world!")`

```
print("hello world!")
print("你好,世界!")
```
````

显示为:

`print("hello world!")`
```
print("hello world!")
print("你好,世界!")
```

分割线

三个及以上的-或*或_即可形成分割线,比如:

---
----
***
___

显示为:





插入表格

使用|分割不同的列,使用---:|:----:|:---进行分隔表头和内容,其中冒号在左边表示左对齐,冒号在两边表示居中对齐,冒号在右边表示右对齐,默认没有冒号的时候是左对齐,而短横线-的数量(至少一个)并不影响分隔效果,比如:

姓名 | 性别 | 年龄
-:|:----:|:---
小明 | 男  | 10
小丽 | 女  | 12

显示为:

姓名 性别 年龄
小明 10
小丽 12

转义

Markdown中使用了很多符号,要想在文本中使用字符本身,则可以在字符前面加上反斜杠\作为转义符。比如:

**粗体**
\*\*普通字体\*\*

显示为:
粗体
**普通字体**
支持转义的字符有:\ 反斜线

`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井号
+   加号
-   减号
.   句点
!   感叹号

结语

个人学习笔记,仅供参考。
详细的教程可以参考菜鸟教程


  1. 这是一段脚注

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容