转到内容

markdown基本语法

已发表: at 00:00

Table of contents

Open Table of contents

标题语法

要创建标题,请在单词或短语前面添加井号 (#) 。 # 的数量代表了标题的级别。 例如,添加三个 # 表示创建一个三级标题 (<h3>) (例如:### My Header)。

Markdown

# 我是Markdown一级标题
## 我是Markdown二级标题
### 我是Markdown三级标题
#### 我是Markdown四级标题

HTML

<h1>我是HTML一级标题</h1>
<h2>我是HTML二级标题</h2>
<h3>我是HTML三级标题</h3>
<h4>我是HTML四级标题</h4>

其它

在文本下方添加任意数量的 == 号来标识一级标题,或者 — 号来标识二级标题。

我是一级标题
===========
我是二级标题
-----------

表格语法

要添加表,请使用三个或多个连字符(---)创建每列的标题,并使用管道(|)分隔每列。您可以选择在表的任一端添加管道。

| Syntax      | Description |
| ----------- | ----------- |
| Header      | Title       |
| Paragraph   | Text        |

对齐

您可以通过在标题行中的连字符的左侧,右侧或两侧添加冒号(:),将列中的文本对齐到左侧,右侧或中心。

| Syntax      | Description | Test Text     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this   |
| Paragraph   | Text        | And more      |

您可以在表格中设置文本格式。例如,您可以添加链接,代码(仅反引号(`)中的单词或短语,而不是代码块)和强调。

您不能添加标题,块引用,列表,水平规则,图像或HTML标签。

您可以使用表格的HTML字符代码(&#124;)在表中显示竖线(|)字符。


代码语法

要将单词或短语表示为代码,请将其包裹在反引号 (`) 中。

Markdown 行内代码

我是Markdown`行内代码`

HTML 行内代码

我是HTML <code>行内代码</code>

转义反引号

Markdown转义

如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(“)中。

``疯狂 `套娃` 模式``

HTML转义

<code>疯狂 `套娃` 模式</code>

代码块

要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符。

    前面四个空格
    前面四个空格
    前面四个空格
    前面四个空格

围栏代码块

    ```
    使用三个反引号包裹
    ```

段落语法

要创建段落,请使用空白行将一行或多行文本进行分隔。

Markdown段落

我是一段文本

我是另一段文本

HTML段落

<p>我是一段文本</p>

<p>我是另一段文本</p>

换行语法

在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行(<br>)。

Markdown换行

我要换行了`空格`

我已经换行了

不打出来不知道怎么展示空格

HTML换行

我要换行了</br>我已经换行了
我要换行了</br>
我已经换行了

链接语法

链接文本放在中括号内,链接地址放在后面的括号中,链接title可选。

超链接Markdown语法代码:[超链接显示名](超链接地址 "超链接title")

对应的HTML代码:<a href="超链接地址" title="超链接title">超链接显示名</a>

这是一个链接 [首页](/)

给链接增加 Title

链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。

这是一个链接 首页

网址和Email地址

使用尖括号可以很方便地把URL或者email地址变成可点击的链接。

链接要带协议头

<https://admin.com>

<admin@admin.com></admin@admin.com>

带格式化的链接

强调 链接, 在链接语法前后增加星号。 要将链接表示为代码,请在方括号中添加反引号。

哈哈哈 **[哈哈哈](https://admin.com)**

嘿嘿嘿 *[嘿嘿嘿](https://admin.com)*

呵呵呵 [`呵呵呵`](https://admin.com)

引用类型链接

引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。参考样式链接分为两部分:与文本保持内联的部分以及存储在文件中其他位置的部分,以使文本易于阅读。

链接的第一部分格式

引用类型的链接的第一部分使用两组括号进行格式设置。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接。

尽管不是必需的,可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。

以下示例格式对于链接的第一部分效果相同:

没看懂这个 平时好像也用不到吧

[文本][1]
[文本] [1]

链接的第二部分格式

引用类型链接的第二部分使用以下属性设置格式:

  1. 放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如[label]:)。
  2. 链接的URL,可以选择将其括在尖括号中。
  3. 链接的可选标题,可以将其括在双引号,单引号或括号中。

以下示例格式对于链接的第二部分效果相同:

[1]: 链接
[1]: 链接 "Title"

完整形式

[文本][1] 普遍放在文章需要插入链接的位置
[1]: 链接 普遍放在文章底部

这是我的[博客][1] 主要放一些色图

[1]:https://laosepiblog.com

列表语法

可以将多个条目组织成有序或无序列表。

Markdown 有序列表

要创建有序列表,请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字 1 起始。

1. 1点+空格+文字
2. 2点+空格+文字
3. 3点+空格+文字
4. 4点+空格+文字

全是1这种显示出来也是1.2.3.4

1. 1点+空格+文字
1. 1点+空格+文字
1. 1点+空格+文字
1. 1点+空格+文字

前面随便什么数字 显示出来也是1.2.3.4

1. 1点+空格+文字
6. 1点+空格+文字
7. 1点+空格+文字
2. 1点+空格+文字

HTML有序列表

<ol>
  <li>li包文本 ol包li</li>
  <li>li包文本 ol包li</li>
  <li>li包文本 ol包li</li>
  <li>li包文本 ol包li</li>
</ol>

Markdown 无序列表

要创建无序列表,请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

- -加空格加文本
- -加空格加文本
- -加空格加文本
* *加空格加文本
* *加空格加文本
* *加空格加文本
+ +加空格加文本
+ +加空格加文本
+ +加空格加文本

HTML 无序列表

<ul>
  <li>li包文本 ul包li</li>
  <li>li包文本 ul包li</li>
  <li>li包文本 ul包li</li>
</ul>

强调语法

通过将文本设置为粗体或斜体来强调其重要性。

粗体

Markdown加粗

我要加 **粗了哦**

注意 前面的两个__之前有个空格

我要加 __粗了哦__

HTML加粗

我要加 <strong>粗了哦</strong>

我一直都用<b>

<b>加粗</b>

斜体

Markdown斜体

我要*歪头了哦*

这个个要注意空格哦

我要 _歪头了哦_

HTML斜体

我要<em>歪头了哦</em>

这种斜体怎么看怎么曝丑 但还经常能看到就很离谱

粗斜 斜粗 又粗又斜

就是多加一个*或者一个_

***又粗又斜***
 ___又粗又斜___

任务列表

任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中,复选框将显示在内容旁边。要创建任务列表,请在任务列表项之前添加破折号-和方括号[ ],并在[ ]前面加上空格。要选择一个复选框,请在方括号[x]之间添加 x

- [x] 起床
- [x] 咖啡500ML
- [ ] 跑步1H
- [ ] 吃早餐

图片语法

要添加图像,请使用感叹号 (!), 然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。

插入图片Markdown语法代码:![图片alt](图片链接 "图片title")

对应的HTML代码:<img src="图片链接" alt="图片alt" title="图片title">

![图片alt](图片链接 "图片title")
![美女图片](https://cdn.jsdelivr.net/gh/52968/picx-images-hosting@master/img/image.es92py1ua.webp "美女交警")

markdown 基本语法

链接图片

给图片增加链接,请将图像的Markdown 括在方括号中,然后将链接添加在圆括号中。

[![图片alt](图片地址 "图片title")](链接地址)

图片并排

有的适用 有的不适用 并排的方式太多了 但不一定每种都有效果

![图一](https://cdn.jsdelivr.net/gh/52968/picx-images-hosting@master/img/image.es92py1ua.webp) | ![图二](https://cdn.jsdelivr.net/gh/52968/picx-images-hosting@master/img/image.es92py1ua.webp) | ![图二](https://cdn.jsdelivr.net/gh/52968/picx-images-hosting@master/img/image.es92py1ua.webp)
---|---
图一图二图二

线条语法

分隔线

要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。

***

---

_________________

以上三个分隔线的渲染效果看起来都一样

删除线

您可以通过在单词中心放置一条水平线来删除单词。结果看起来像这样。此功能使您可以指示某些单词是一个错误,要从文档中删除。若要删除单词,请在单词前后使用两个波浪号~~。

~~删除线~~

删除线


标题编号

许多Markdown处理器支持标题的自定义ID

### 俺是标题 {#自定义-id}

对应的HTML样式

<h3 id="自定义-id">俺是标题</h3>

链接到标题ID (#headid)

通过创建带有数字符号(#)和自定义标题ID的[标准链接]((/basic-syntax/links.html),可以链接到文件中具有自定义ID的标题。

Heading IDs

Heading IDs

例如

Heading IDs


引用语法

要创建块引用,请在段落前添加一个 > 符号。

>前面带个`>`就是引用哦

块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号

>前面带个`>`就是引用哦
>
>前面带个`>`就是引用哦
>前面带个`>`就是引用哦

块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。

>嵌套
>
>>是个
>>
>>>啥玩楞
>>>
>>>>层级吗
>>>>
>>>>>第一次玩
> ## 标题?
>
> - 无序
> - 列表
>
> 1. 有序
> 2. 列表
>
> *歪头*  **加粗**
>
>> 嵌套 ***歪粗***
>>
>>>___歪粗___

转义字符

要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \ 。

\* 要显示原本用于格式化 Markdown 文档的字符,请在字符前面添加反斜杠字符 \ 

可做转义的字符

以下列出的字符都可以通过使用反斜杠字符从而达到转义目的。

特殊字符自动转义

在 HTML 文件中,有两个字符需要特殊处理: <&< 符号用于起始标签,&符号则用于标记 HTML 实体,如果你只是想要使用这些符号,你必须要使用实体的形式,像是 &lt;&amp;

& 符号其实很容易让写作网页文件的人感到困扰,如果你要打「AT&T」 ,你必须要写成「AT&amp;T」 ,还得转换网址内的 & 符号,如果你要链接到:

http://images.google.com/images?num=30&q=larry+bird

你必须要把网址转成:

http://images.google.com/images?num=30&amp;q=larry+bird

才能放到链接标签的 href 属性里。不用说也知道这很容易忘记,这也可能是 HTML 标准检查所检查到的错误中,数量最多的。

Markdown 允许你直接使用这些符号,它帮你自动转义字符。如果你使用 & 符号的作为 HTML 实体的一部分,那么它不会被转换,而在其它情况下,它则会被转换成 &amp;。所以你如果要在文件中插入一个著作权的符号,你可以这样写:

&copy;

Markdown 将不会对这段文字做修改,但是如果你这样写:

AT&T

Markdown 就会将它转为:

AT&amp;T

类似的状况也会发生在 < 符号上,因为 Markdown 支持 行内 HTML ,如果你使用 < 符号作为 HTML 标签的分隔符,那 Markdown 也不会对它做任何转换,但是如果你是写:

4 < 5 Markdown 将会把它转换为:

4 &lt; 5

需要特别注意的是,在 Markdown 的块级元素和内联元素中, <& 两个符号都会被自动转换成 HTML 实体,这项特性让你可以很容易地用 Markdown 写 HTML。(在 HTML 语法中,你要手动把所有的 <& 都转换为 HTML 实体。)