Markdown使用教程

时间:2023-12-25 16:47:55

Markdown 是一种 轻量级标记语言,主要特点是:使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。

本文参考了:语法手册简书介绍

常用语法

一、标题

1、Markdown里的标题有6个级别,前面加一个#到加6个#。你也可以在行尾加上 #,而行尾的 # 数量也不用和开头一样。如下:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
或者:
# 一级标题 #
## 这是 H2 ##
### 这是 H3 #

效果如下:

Markdown使用教程

2、一级和二级标题还有一种写法 就是下面加横杆,同时 超过2个的 = 和 - 都可以有效果。:

This is an H1
==
This is an H2
-------------

效果如下:

Markdown使用教程

二、代码引用

1、上面我们就用到了代码引用,本来用# 符号 是会显示标题样式,但是上面并没有,这是因为我们在 需要引用的上下加了```。上面效果的实际书写为:

Markdown使用教程

2、或者使用 4 空格缩进,上面要空一行如:

    This is an H1

效果如下:

This is an H1

三、图片

使用 ![描述](图片链接地址) 插入图像。或者: ![](图片链接地址) 。

比如:

Markdown使用教程

四、链接

1、显示链接的语法为:[显示文本](链接地址) 。比如:

[我的首页](http://www.jianshu.com/u/f41360dec64d)

效果: 我的首页

2、另一种超链接写法:[链接名][链接代号],然后在别的地方定义 链接代号的链接信息,如:

[here][3]
[3]: http://www.jianshu.com/u/f41360dec64d

效果:[我的首页][3]

[3]: http://www.jianshu.com/u/f41360dec64d

五、斜体和粗体

使用 * 和 ** 表示斜体和粗体,也可以用_和__。比如:

*斜体* : 斜体

**粗体** : 粗体

***粗斜体文本*** : 粗斜体文本

六、无序列表

使用 *,+,- 表示无序列表。比如:

- 无序列表项1
- 无序列表项2

显示效果为:

  • 无序列表项1
  • 无序列表项2

七、有序列表

使用数字和点表示有序列表。如:

1.无序列表项1
2.无序列表项2

显示效果为:

  1. 有序列表项1
  2. 有序列表项2

八、文字引用

使用 > 表示文字引用。如:

> 野火烧不尽,春风吹又生。

显示的效果为:

野火烧不尽,春风吹又生。

九、行内代码块

使用 `代码 ` 表示行内代码块。如:

我的 `作品 `

显示效果为:

我的 作品

十、表格

格式如下,其中 |----| 或者 |:----: |表示居中,|:---- |表示左对齐,|-----:|表示右对齐。最上面要空一行。

| 我的博客 | 浏览量   |  点赞量  |
| ----  | -----:  | :----    |
| 简书     | 1000 |   500     |
| 博客园 | 2000  |   120  |

显示效果如下:

我的博客 浏览量 点赞量
简书 1000 500
博客园 2000 120

十一、段落

以一个空行开始,以一个空行结束,中间的就是一个段落。

十二、分隔线

下面的任何一种都可以,重复的个数超过2个:

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

效果如下:

***

十三、删除线

使用 ~~ 表示删除线。如下:

~~这是一段错误的文本。~~

效果如下:

这是一段错误的文本。

十四、符号转义

如果想输出特殊字符如: _ # * 等,就在这些符号前加反斜杠,如\#进行避免。

\_符号转义\_

显示的效果为:

_符号转义_

高级功能

上面的内容基本已经够大多数人用了。下面的高级功能,大家可以不用看。

十五、注脚

使用 [^keyword] 表示注脚。效果如下:

Markdown使用教程

十六、兼容 HTML

1、table:

Markdown使用教程

2、粗斜体也可以用,如:

<b>  加粗 </b>

效果如下:

加粗

十七、键盘键

Markdown使用教程

十八、版权符号

所以你如果要在文档中插入一个版权符号©,你可以这样写:

©

十九、使用软件

我的是mac系统。用的是 MacDown、Typora