Markdown语法简介

最新推荐文章于 2023-04-12 20:03:01 发布

川峰

最新推荐文章于 2023-04-12 20:03:01 发布

阅读量323

点赞数

文章标签： Markdown语法 Markdown

本文链接：https://blog.csdn.net/lyabc123456/article/details/79875228

版权

MarkDown 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

Markdown是一种轻量级的标记语言，它可以使用极少数的标记符号来获得较为丰富的表达形式。
它的简单方便高效，使得编辑者可以更多的关注编辑内容。同时，Markdown支持和兼容部分HTML标记，这也极大的丰富了Markdown的展现样式。

Markdown常用语法

标题

1. 用#标记

在 标题开头 加上1~6个#，依次代表一级标题、二级标题….六级标题

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

注意，#跟后面的文字有一个空格
展示效果：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

2. 用=和-标记

在标题底下加上任意个 = 代表一级标题，- 代表二级标题

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

展示效果：

一级标题

二级标题

粗体和斜体

两个 * 或 _ 代表加粗，一个 * 或 _ 代表斜体，~~代表删除。

**这是加粗文本** 或者 __这是加粗文本__

*这是斜体文本*  或者 _这是斜体文本_

***这是加粗斜体*** 或者 ___这是加粗斜体___

~~这是删除文本~~

展示效果：
这是加粗文本 或者 这是加粗文本

这是斜体文本 或者 这是斜体文本

这是加粗斜体 或者 这是加粗斜体

~~这是删除文本~~

列表

1. 无序列表

无序列表使用 *，+，- 来表示

* Red
* Green
* Blue

+ Red
+ Green
+ Blue

- Red
- Green
- Blue

展示效果：

Red
Green
Blue

2. 有序列表

有序列表使用数字后面加英文句号表示。

1. Red
2. Green
3. Blue

展示效果：
1. Red
2. Green
3. Blue

这里有个地方要注意，在列表标记上使用的数字并不会影响输出的 HTML 结果，上面的列表所产生的 HTML 标记为：

<ol>
<li>Red</li>
<li>Green</li>
<li>Blue</li>
</ol>

如果你的列表标记写成：

1.  Bird
1.  McHale
1.  Parish

或者甚至是：

3. Bird
1. McHale
8. Parish

你都会得到完全相同的 HTML输出。如果你懒一点，你可以完全不用在意数字的正确性，但最好还是从1开始保持一致。

3. 列表缩进

列表项目标记通常是放在最左边，但是其实也可以缩进，最多3个空格，项目标记后面则一定要接着至少一个空格或制表符。
要让列表看起来更漂亮，你可以把内容用固定的缩进整理好：

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.

但是如果你比较懒，你可以这样：

*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

展示效果都是一样的：

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符（显示效果与代码一致）：

1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.

    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.

2.  Suspendisse id sem consectetuer libero luctus adipiscing.

如果你每行都有缩进，看起来会看好很多，当然，如果你很懒惰，Markdown 也允许你这样做：

*   This is a list item with two paragraphs.

    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.

*   Another item in the same list.

展示效果：

This is a list item with two paragraphs.

This is the second paragraph in the list item. You’re
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.
Another item in the same list.

4. 包含引用的列表

如果要在列表项目内放进引用，那 > 就需要缩进：

*   阅读的方法:
    > 打开书本。
    > 打开电灯。

展示效果:

阅读的方法:

打开书本。
打开电灯。

如果要放代码区块的话，该区块就需要缩进两次，也就是 8 个空格或是 2 个制表符：

*   一列表项包含一个列表区块：

        <代码写在这>

当然，项目列表很可能会不小心产生，像是下面这样的写法：

1986. What a great season.

会展示为：

What a great season.

换句话说，也就是在行首出现数字-句点-空白，要避免这样的状况，你可以在句点前面加上反斜杠。

1986\. What a great season.

分隔线

你可以在一行中用三个以上的 * 或者 - 或者 _ 来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

* * *
***
*****
- - -
_ _ _

展示效果：

也可以使用html标记<hr>做分割线

引用

引用需要在被引用的文本前加上>符号。

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> 
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > ：

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

展示效果：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

引用内也可以多层嵌套（引用内的引用），只要根据层次加上不同数量的 > ：

>>> 请问 Markdwon 怎么用？ - 小白
>> 自己看教程！ - 愤青
> 教程在哪？ - 小白

展示效果：

请问 Markdwon 怎么用？ - 小白

自己看教程！ - 愤青

教程在哪？ - 小白

引用的区块内也可以使用其他的 Markdown语法，包括标题、列表、代码区块等：

> ## 这是一个标题。
> 
> 1.   这是第一行列表项。
> 2.   这是第二行列表项。
> 
> 给出一些例子代码：
> 
>     return shell_exec("echo $input | $markdown_script");

展示效果：

这是一个标题。

这是第一行列表项。
这是第二行列表项。

给出一些例子代码：
return shell_exec("echo $input | $markdown_script");

换行

在行尾添加两个空格加回车表示换行：

这是一行后面加两个空格  换行

效果如下：
这是一行后面加两个空格
换行
也可以使用html标记<br/>标签换行

插入图片与链接

1. 图片

图片与链接的语法很像，区别在一个 ! 号。二者格式：

图片：![]()    ![图片文本(可忽略)](图片地址)
链接：[]()     [链接文本](链接地址)

例如展示图片：

![考拉](https://i-blog.csdnimg.cn/blog_migrate/5032803d44d935de2b1f09eaa48c8858.jpeg)

注意前面的！是英文的！
[]内是描述文本，描述文本不会显示出来，()内是图片链接
展示效果：

目前Markdown只能插入在线的图片地址, 可以利用第三方图床生成图片外链或者将图片上传到github也能获取到图片外链，这里推荐一个sm.ms可以很方便的生成图片外链，另外CSDN发表博客的markdown编辑页面也提供了上传图片功能。
到目前为止, Markdown还没有办法指定图片的宽高，如果你需要的话，你可以使用普通的html标签<img> 来设置。例如：

<img src="https://i-blog.csdnimg.cn/blog_migrate/5032803d44d935de2b1f09eaa48c8858.jpeg" width="50%">

展示效果：

2. 链接

形式为：[链接文字](链接地址 “链接标题”)
链接地址与链接标题间有一个空格。
举例：

[程序猿最喜欢的网站是Gayhub!!!](https://www.github.com "Github")

[]里写链接文字，()里写链接地址, ()中的”“中可以为链接指定title属性，title属性可加可不加。title属性的效果是鼠标悬停在链接上会出现指定的 title文字。

展示效果：
程序猿最喜欢的网站是Gayhub!!!

链接又分为行内式、参考式和 自动链接
行内式
行内式就是像上面那样，链接直接写在()里面：

[点击访问百度](http://www.baidu.com)

展示效果：
点击访问百度

参考式
参考式一般用在学术论文上面，或者某一个链接在文章中多处使用的情况
参考式链接分为两部分：
[链接文字][链接标记]
然后在文本的任意位置添加：
[链接标记]:链接地址 “链接标题”
链接地址与链接标题间有一个空格。

如果链接文字本身可以做为链接标记，你也可以写成
[链接文字][]
[链接文字]：链接地址
这样的形式
举例：

程序猿最爱去的几个网站：[Github][1]，[CSDN][2]，[百度][3]，[Google][4]，[StackoverFlow][5]，推荐一个不错的笔记：[印象笔记][6]，[印象笔记][6]可以在PC和手机端同时操作，[Segmentfault][]是一个不错的问答网站。
[1]:https://www.github.com "Github"
[2]:http://blog.csdn.net/ "CSDN"
[3]:http://www.baidu.com "百度"
[4]:http://www.google.com "Google"
[5]:https://stackoverflow.com/ "Stack Overflow"
[6]:https://www.yinxiang.com/ "印象笔记"
[Segmentfault]:https://segmentfault.com/ "Segmentfault"

展示效果：
程序猿最爱去的几个网站：Github，CSDN，百度，Google，StackoverFlow，推荐一个不错的笔记：印象笔记，印象笔记可以在PC和手机端同时操作，Segmentfault是一个不错的问答网站。
自动链接
自动链接很简单,将链接用<>括起来就可以
例：

这是一个自动链接：<https://developer.android.google.cn/index.html>

展示效果：
这是一个自动链接：https://developer.android.google.cn/index.html

代码块

如要插入代码块，可以使用4个空格或者Tap键缩进，或者以三个 ` 符合开始，并以三个 ` 结束即可
` ` `
<我是代码>
` ` `
如果要支持代码块语法高亮，在“`后面加上你的代码所属编程语言类型即可
` ` ` 语言类型
<我是代码>
` ` `
例：

 ``` java
 protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
 }
 ```

注意“`跟语言类型之间有一个空格
展示效果：

 protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
 }

如果要在行内插入一句代码，可以使用`code`这样的形式插入：

C语言里的函数 `scanf()` 怎么使用？

展示效果：
C语言里的函数 scanf() 怎么使用？

在代码区块里面， & 、 < 和 > 会自动转成 HTML 实体，这样的方式让你非常容易的使用 Markdown 插入 HTML 标记效果，只需要复制贴上，剩下的 Markdown 都会帮你处理，例如：

<div style="color:#ff0000;">值班统计表： </div>
<table>
    <tr>
        <th rowspan="2">值班人员</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李强</td>
        <td>张明</td>
        <td>王平</td>
    </tr>
</table>

展示效果：

值班统计表：

值班人员	星期一	星期二	星期三
值班人员	李强	张明	王平

锚点

锚点其实就是页内超链接，点击锚点可以跳转到页面内标记的地方，实现当前页面中的跳转。注意，Markdown Extra只支持在标题后插入锚点，其它地方无效。
语法描述：
在你准备跳转到的指定标题后插入锚点{#标记}，然后在文档的其它地方写上连接到锚点的链接。
例如：

## 0. 目录{#index}
跳转到[目录](#index)

展示效果：
点击回到顶部

转义字符

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

例如:

这是反斜线\\， 
这是井号\#，
这是反引号\`

展示效果：
这是反斜线\，
这是井号#，
这是反引号`

表格

表格采用竖线和横线符合，用|分割列，第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。第二行用-指定对齐方式，可以为不同的列指定对齐方向。默认为左对齐，在-右边加上:就右对齐，在-两边都加上:就是居中对齐。
例：

|标题|标题|标题|
|:---|:---:|---:|
|居左测试文本|居中测试文本|居右测试文本|
|居左测试文本1|居中测试文本2|居右测试文本3|
|居左测试文本11|居中测试文本22|居右测试文本33|
|居左测试文本111|居中测试文本222|居右测试文本333|
|居左测试文本111|文本换行文本换行<br/>文本换行文本换行|居右测试文本|

展示效果：

标题	标题	标题
居左测试文本	居中测试文本	居右测试文本
居左测试文本1	居中测试文本2	居右测试文本3
居左测试文本11	居中测试文本22	居右测试文本33
居左测试文本111	居中测试文本222	居右测试文本333
居左测试文本	文本换行文本换行文本换行文本换行	居右测试文本

（如果这里你没能看到正确的显示结果，说明CSDN的markdown渲染机制有点问题，但我们的语法是没有错的。）

当然，其中的-你只写一个也是可以的，如：

|学号|姓名|分数|
|-|-|-|
|小明|男|75|
|小红|女|79|
|小陆|男|92|

展示效果：

学号	姓名	分数
小明	男	75
小红	女	79
小陆	男	92

你也可以通过Html的标签<table>来实现表格。

公式

行内公式

$ 表示行内公式：

质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。

展示效果：
质能守恒方程可以用一个很简洁的方程式 $E=mc^2$ 来表达。

整行公式

$$ 表示整行公式：

$$\sum_{i=1}^n a_i=0$$
$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$
$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$

展示效果：

\sum i = 1 n a i = 0

$\sum_{i=1}^n a_i=0$

f (x 1, x x, \dots, x n) = x 21 + x 22 + \dots + x 2 n

$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2$

\sum k = 0 j - 1 γ ˆ k j z k

$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$
更多使用方法请参考 MathJax 。
这些公式表达方式貌似有些Markdown编辑器是不支持, 假如你现在看到了公式说明CSDN也是支持的，因为本文就是用markdown写的。

注脚

注脚使用 [^keyword] 表示。
例：

这是一个注脚[^footnote]的样例。

这是第二个注脚[^footnote2]的样例。

展示效果：
这是一个注脚1的样例。

这是第二个注脚2的样例。

其它Html标签

字体：

<font face="微软雅黑" color="red" size="6">字体及字体颜色和大小</font>
<font color="#0000ff">字体颜色</font>

展示效果：
字体及字体颜色和大小
字体颜色

文本对齐方式：

<div align="left">居左文本</div>
<div align="center">居中文本</div>
<div align="right">居右文本</div>

展示效果:

居左文本

居中文本

居右文本

下划线：

<u>下划线文本</u>

展示效果:
下划线文本

这是一个注脚的文本。 ↩
这是另一个注脚的文本。 ↩

川峰

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
打赏
0
评论
Markdown语法简介

Markdown是一种轻量级的标记语言，它可以使用极少数的标记符号来获得较为丰富的表达形式。它的简单方便高效，使得编辑者可以更多的关注编辑内容。同时，Markdown支持和兼容部分HTML标记，这也极大的丰富了Markdown的展现样式。Markdown常用语法标题1. 用#标记在标题开头加上1~6个#，依次代表一级标题、二级标题….六级标题# ...
复制链接

扫一扫