Markdown从入门到精通

已于 2023-07-16 00:06:16 修改
阅读量236 收藏
点赞数 1
分类专栏： MarkDown 文章标签： html html5
于 2023-07-16 00:01:04 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_71417856/article/details/131745766
版权

超全面的Markdown语法

一.什么是 MarkDown

Markdown 是一种轻量级的标记语言，可用于在纯文本文档中添加格式化元素。Markdown 由 John Gruber 于 2004 年创建，如今已成为世界上最受欢迎的标记语言之一。
在这里插入图片描述

  1. 专注于文字内容
  2. 纯文本，易读易写，可以方便地纳入版本3. 控制
  3. 语法简单，没有什么学习成本，能轻松在码字的同时做出美观大方的排版

Markdown 语法的首要设计目标是尽可能易读。基于这个目标，Markdown 格式的文档能够以纯文本形式原样发布，而不会看起来像被填满了标签或格式化指令。

二.为什么要使用Markdown

  • Markdown 无处不在。StackOverflow、CSDN、掘金、简书、GitBook、有道云笔记、V2EX、光谷社区等。主流的代码托管平台，如 GitHub、GitLab、BitBucket、Coding、Gitee 等等，都支持 Markdown 语法，很多开源项目的 README、开发文档、帮助文档、Wiki 等都用 Markdown 写作。

  • Markdown 是纯文本可移植的。几乎可以使用任何应用程序打开包含 Markdown 格式的文本文件。如果你不喜欢当前使用的 Markdown 应用程序了，则可以将 Markdown 文件导入另一个 Markdown 应用程序中。这与 Microsoft Word 等文字处理应用程序形成了鲜明的对比，Microsoft Word 将你的内容锁定在专有文件格式中。

  • Markdown 是独立于平台的。你可以在运行任何操作系统的任何设备上创建 Markdown 格式的文本。

  • Markdown 能适应未来的变化。即使你正在使用的应用程序将来会在某个时候不能使用了，你仍然可以使用文本编辑器读取 Markdown 格式的文本。当涉及需要无限期保存的书籍、大学论文和其他里程碑式的文件时，这是一个重要的考虑因素。
    在这里插入图片描述

三.Markdown的基础语法

Markdown 入门的最佳方式就是多使用它。在阅读本篇博客时，你可以打开在线Markdown编辑器。这样，你就可以一边学习 Markdown 语法一边练习了。熟悉 Markdown 之后，再选择一个顺手的 Markdown 的应用程序

1. 标题语法

在英文状态下输入#，有几个就代表几级标题，最多可以输入六个，也就是说最多可以输入六级标题

Markdown语法HTML代码预览效果
# Heading level 1<h1>Heading level 1</h1>

Heading level 1

## Heading level 2<h2>Heading level 2</h2>

Heading level 2

### Heading level 3<h3>Heading level 3</h3>

Heading level 3

#### Heading level 4<h4>Heading level 4</h4>
Heading level 4
##### Heading level 5<h5>Heading level 5</h5>
Heading level 5
###### Heading level 6<h6>Heading level 6</h6>
Heading level 6

1.1 可选语法

还可以在文本下方添加任意数量的 == 号来标识一级标题，或者 – 号来标识二级标题

Markdown语法HTML代码预览效果
Heading level 1
===========		<h1>Heading level 1</h1>

Heading level 1

Heading level 2
---------------		<h2>Heading level 2</h2>

Heading level 2

1.2 标题的最佳实践

不同平台和工具可能采用不同的Markdown解析引擎或自定义扩展，不同的 Markdown 应用程序处理 # 和标题之间的空格方式并不一致。为了兼容考虑，请用一个空格在 # 和标题之间进行分隔。

✅ Do this❌ Don’t do this
# Here’s a Heading#Here’s a Heading

2. 段落语法

  1. 段落换行：为了在Markdown中创建新的段落，只需在段落之间添加一个空行即可。这将被解析为段落间的换行。
这是第一个段落。

这是第二个段落。
  1. 行尾加两个空格：在一行的末尾添加两个空格，然后回车，可以实现行内的换行效果。
这是一行文本，  
这是同一行的另一行文本。

注意：在某些Markdown解析器中，行尾加两个空格的方法可能不适用，因此最好在目标平台上预览效果。

3. **强制换行**:使用HTML的<br>标签可以在Markdown中插入强制换行。

这是一行文本。<br>
这是同一行的另一行文本。

注意：行尾加两个空格以及使用HTML标签的方法可能不适用于所有Markdown解析器，所以最好在目标平台上预览效果。

2.1 段落的最佳实践

不要用空格（spaces）或制表符（ tabs）缩进段落。

✅ 这样做❌ 别这样
这是第一个段落
这是第二个段落		这是第一个段落
              ~~~~~~~~~~~~~              这是第二个段落

3. 强调语法

在Markdown中，你可以使用强调语法来突出显示文本，使其在渲染时以斜体或粗体显示

3.1 斜体（Italic）

要用斜体显示文本，请在单词或短语前后添加一个星号（asterisk）或下划线（underscore）

Markdown语法.HTML预览效果
Italicized text is the *cat's meow*. Italicized text is the <em>cat's meow</em>. 斜体文字是猫的喵喵声。
Italicized text is the _cat's meow_. Italicized text is the <em>cat's meow</em>. 斜体文字是 猫的喵喵声。

3.2 粗体（Bold）

要加粗文本，请在单词或短语的前后各添加两个星号（asterisks）或下划线（underscores）

Markdown语法.HTML预览效果
This text is ***really important***.This text is <strong><em>really important</em></strong>.这段文字真的很重要。
This text is ___really important___.This text is <strong><em>really important</em></strong>.这段文字 真的很重要
This text is __*really important*__.This text is <strong><em>really important</em></strong>.这段文字 真的很重要
This text is **_really important_**.This text is <strong><em>really important</em></strong>.这段文字 真的很重要
This is really***very***important text.This is really<strong><em>very</em></strong>important text.这确实是非常重要的文本。

3.3 强调语法的最佳实践

Markdown 应用程序在处理单词或短语中间添加的下划线上并不一致。 为了实现兼容性，请使用星号将单词或短语的中间部分加粗并以斜体显示，以示重要。

✅ 这样做❌ 别这样
This is really ***very*** important text.This is really___very___important text.

(即尽量使用星号而非下划线)

4. 引用语法

> 这是Markdown中的引用文本。
> 它可以跨越多行。
> 常用于引用块或引述。

渲染效果如下所示：

这是Markdown中的引用文本。
它可以跨越多行。
常用于引用块或引述。

4.1 多个段落的块引用

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

> 这是第一个段落的引用。
>
> 这是第二个段落的引用。
>
> 这是第三个段落的引用。

渲染效果如下所示：

这是第一个段落的引用。

这是第二个段落的引用。

这是第三个段落的引用。

4.2 嵌套块引用

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

> 这是外层的引用块。
>
>> 这是嵌套在外层引用块中的内层引用块。
>>
>> 这是内层引用块中的第二个段落。
>
> 这是外层引用块中的第二个段落。

渲染效果如下所示：

这是外层的引用块。

这是嵌套在外层引用块中的内层引用块。

这是内层引用块中的第二个段落。

这是外层引用块中的第二个段落。

4.3 带有其它元素的块引用

块引用可以包含其他 Markdown 格式的元素。 并非所有元素都可以使用，你需要进行实验以查看哪些元素有效

> 这是一个包含不同Markdown元素的块引用示例：
>
> - **粗体文本**
> - *斜体文本*
> - [链接](https://blog.csdn.net/m0_71417856?type=blog)
> - `代码块`
> - 有序列表：
>    1. 项目一
>    2. 项目二
>    3. 项目三
>
> 这是块引用中的最后一个段落。

渲染效果如下所示：

这是一个包含不同Markdown元素的块引用示例：

  • 粗体文本
  • 斜体文本
  • 链接
  • 代码块
  • 有序列表：
    1. 项目一
    2. 项目二
    3. 项目三

这是块引用中的最后一个段落。

5. 列表语法

用于表示项目的有序或无序集合的语法

5.1 有序列表

有序列表使用数字或字母后跟一个英文句点作为列表项的标记。列表项按照其在列表中的顺序进行编号。有序列表的语法如下：

MarkdownHTML预览效果
1. First item
2. Second item
3. Third item
4. Fourth item		<ol>
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ol>		1. First item
2. Second item
3. Third item
4. Fourth item
1. First item
2. Second item
3. Third item
    1. Indented item
    2. Indented item
4. Fourth item		<ol>
<li>First item</li>
<li>Second item</li>
<li>Third item
    <ol>
    <li>Indented item</li>
    <li>Indented item</li>
    </ol>
</li>
<li>Fourth item</li>
</ol>		1. First item
2. Second item
3. Third item
    1. Indented item
    2. Indented item
4. Fourth item

5.2 有序列表最佳实践

CommonMark 和其他一些轻量级标记语言允许您使用括号 （） 作为分隔符（例如，），但并非所有 Markdown 应用程序都支持此功能，因此从兼容性的角度来看，这不是一个不错的选择。为了兼容，请仅使用句点.

✅ 这样做❌ 别这样
1. First item
2. Second item		1) First item
2) Second item

5.3 无序列表

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

MarkdownHTML预览效果
- First item
- Second item
- Third item
- Fourth item		<ul>
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ul>		- First item
- Second item
- Third item
- Fourth item
* First item
* Second item
* Third item
* Fourth item		<ul>
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ul>		* First item
* Second item
* Third item
* Fourth item
+ First item
+ Second item
+ Third item
+ Fourth item		<ul>
<li>First item</li>
<li>Second item</li>
<li>Third item</li>
<li>Fourth item</li>
</ul>		+ First item
+ Second item
+ Third item
+ Fourth item
- First item
- Second item
- Third item
    - Indented item
    - Indented item
- Fourth item		<ul>
<li>First item</li>
<li>Second item</li>
<li>Third item
        <ul>
        <li>Indented item</li>
        <li>Indented item</li>
     </ul>
</li>
<li>Fourth item</li>
</ul>		- First item
- Second item
- Third item
    - Indented item
    - Indented item
- Fourth item

5.4 无序列表最佳实践

为了确保兼容性，不同的 Markdown 应用程序在处理同一列表时可能对不同的分隔符表现出不同的行为。因此，为了保持一致，请在同一列表中选择一种分隔符，并始终坚持使用该分隔符。避免混合和匹配不同的分隔符。

✅ 这样做❌ 别这样
- First item
- Second item
- Third item		1) First item
2) Second item
3) Third item

5.5 在列表中嵌套其他元素

5.5.1 段落
*   This is the first list item.
*   Here's the second list item.

    I need to add another paragraph below the second list item.

*   And here's the third list item.

渲染效果如下所示：

  • 这是第一个列表项。

  • 这是第二个列表项。

    我需要在第二个列表项下面再添加一段。

  • 这是第三个列表项。

5.5.2 引用块
*   This is the first list item.
*   Here's the second list item.

    > A blockquote would look great below the second list item.

*   And here's the third list item.

渲染效果如下所示：

  • 这是第一个列表项。

  • 这是第二个列表项。

    块引用在第二个列表项下方看起来很棒。

  • 这是第三个列表项。

5.5.3 代码块

代码块通常采用四个空格或一个制表符缩进。 当它们被放在列表中时，请将它们缩进八个空格或两个制表符。

- First item

    def example_function():
        print("This is an example")

- Second item

    ```python
    def another_function():
        print("Another example")
    ```

- Third item

渲染效果如下所示：

  • First item

    def example_function():
    print(“This is an example”)

  • Second item

    def another_function():
    print("Another example")

  • Third item

注意通常在列表中的代码块前需要先空一行。这是为了确保代码块与列表项之间有明确的分隔，并提供更好的可读性

5.5.4 图片
1. Open the file containing the ChatGPT.

2. Marvel at its power.

	ChatGPT

3. Close the file.

渲染效果如下所示：

  1. 打开包含ChatGPT的文件。

  2. 惊叹于其强大之处。

    ChatGPT

  3. 关闭文件。

5.5.5 列表

可以将无序列表嵌套在有序列表中，反之亦然。

1. First item
2. Second item
3. Third item
    - Indented item
    - Indented item
4. Fourth item

渲染效果如下所示：

  1. 第一项
  2. 第二项
  3. 第三项
    • 缩进项
    • 缩进项
  4. 第四项

6. 代码语法

当需要在文本中将单词或短语表示为代码时，可以使用反引号 (`) 将其包裹起来。以下是一个示例：

Markdown语法.HTML预览效果
# Heading 1<h1>Heading 1</h1>

Heading 1

**Bold Text**<strong>Bold Text</strong>Bold Text
- List item 1<ul><li>List item 1</li></ul>
  • List item 1
1. Item 1<ol><li>Item 1</li></ol>
  1. Item 1
![Image](image.jpg)<img src="image.jpg" alt="Image">Image

6.1 转义反引号

如果你要表示为代码的单词或短语中包含一个或多个反引号，你可以使用双反引号``

Markdown语法.HTML预览效果
`````在你的Markdown文件中使用 code。`` ```<code>在你的Markdown文件中使用 `code` 。</code>在你的Markdown文件中使用 `code`。

6.2 代码块

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

    <html>
      <head>
      </head>
    </html>

渲染效果如下所示：

	<html>
	  <head>
	  </head>
	</html>

7. 分隔线语法

在Markdown中，你可以使用三个或更多的连字符（-）、星号（*）或下划线（_）来创建分隔线

---
***
___

- - -

* * *
_ _ _

渲染效果如下所示：

7.1 分隔线的最佳实践

为了兼容性，请在分隔线的前后均添加空白行

✅ 这样做❌ 别这样
在水平分隔线之前和之后加上空行是一种良好的习惯

- - -

这样可以更清晰地分隔内容		这样的文本会被解析为标题
- -
不要这样做

8. 链接语法

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

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

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

这是一个链接 [个人主页](https://blog.csdn.net/m0_71417856?spm=1010.2135.3001.5421)。

渲染效果如下所示：

这是一个链接 个人主页。

8.1 给链接增加 Title

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

这是一个链接 [个人主页](https://blog.csdn.net/m0_71417856?spm=1010.2135.3001.5421 "博主本人的个人主页")。

渲染效果如下所示：

这是一个链接 个人主页。

8.2 网址和Email地址

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

<https://openai.com>

<email@example.com>

渲染效果如下所示：

https://openai.com

email@example.com

8.3 带格式化的链接

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

*强调* [链接](https://example.com)

_强调_ [`链接`](https://example.com)

强调 **[链接](https://example.com)**

__强调__ [`链接`](https://example.com)

渲染效果如下所示：

强调 链接

强调 链接

强调 链接

强调 链接

8.4 引用类型链接

引用样式链接是Markdown中的一种链接格式，使得URL在文本中更易于显示和阅读。它分为两部分：链接的内联部分和链接的引用部分，通过引用部分将链接的详细信息存储在文档的其他位置。

这是一个[示例链接][1]。

[1]: https://example.com "链接标题"

在上面的示例中，链接的内联部分是 [示例链接][1]，其中 [示例链接] 是链接的显示文本，而 [1] 是一个标签，用于指向引用部分中的链接详细信息。

引用部分可以放置在Markdown文档的任何位置，通常放在文档的末尾或专门的引用部分。这样可以使文档更易于阅读，因为链接的详细信息不会分散到文本中，而是集中在一个地方。

渲染效果如下所示：

这是一个示例链接。

8.5 链接的最佳实践

不同的 Markdown 应用程序处理URL中间的空格方式不一样。 为了兼容性，请尽量使用%20代替空格。

✅ 这样做❌ 别这样
1: https://example.com/page%20with%20spaces “Example Page with Spaces”1: https://example.com/page with spaces “Example Page with Spaces”

9. 图片语法

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

![替代文本](图片URL)

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

渲染效果如下所示：

![这是一张图片](https://i-blog.csdnimg.cn/blog_migrate/6d530a43137cf60ef0bbd69ed0a9ee68.png)

这是一张图片

9.1 链接图片

给图片增加链接，请将图像的Markdown 括在方括号中，然后将链接添加在圆括号中。
在这里插入图片描述

[![一张图片](https://i-blog.csdnimg.cn/blog_migrate/de909fc52cdb111825ce7b199b2e10bc.png)](https://blog.csdn.net/m0_71417856?spm=1010.2135.3001.5421)

渲染效果如下所示：
一张图片

可点击图片跳转

10. 转义字符语法

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

\# Heading
\- Emphasis
\[Link\](https://example.com)
\![Image\](image.jpg)

渲染效果如下所示：

# Heading
- Emphasis
[Link](https://example.com)
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-4qbwZPru-1689437123965)(image.jpg)]

10.1 可做转义的字符

以下是Markdown表格示例，显示可用于转义的字符及其描述：

字符描述
\\反斜杠字符
\*星号
\_下划线
\[左方括号
\]右方括号
\<小于号
\>大于号
\#井号
\+加号
\-减号
\.句点
\!感叹号

10.2 特殊字符自动转义

当在HTML文件中使用特殊字符时，有两个字符需要特别处理：< 和 &。 < 用于起始标签，& 则用于标记HTML实体。如果你想直接使用这些字符，必须将它们转换为实体形式，例如使用 < 和 &。

在Markdown中，你可以直接使用这些字符，它会自动为你转义这些特殊字符。如果你使用 & 作为HTML实体的一部分，它不会被转换；其他情况下，它会被转换为 &。同样地，如果你使用 < 作为HTML标签的分隔符，Markdown也不会对其进行转换；但是，在其他情况下，它会被转换为 <。

Markdown的转义规则也适用于Markdown中的内联HTML。当在块级元素和内联元素中使用特殊字符时，Markdown会自动转换它们为HTML实体，以确保正确的显示。

举例：

<a href="http://example.com/page?param1=value1&;param2=value2">链接</a>

你必须要把网址转成：

<a href="http://example.com/page?param1=value1&amp;param2=value2">链接</a>

另外还有版权符号：&copy;©，非断空格：&nbsp;

在使用VS Code进行HTML编写时，通常不需要手动转义特殊字符，包括 & 符号。VS Code内置的HTML语法高亮和智能提示功能会自动处理这些特殊字符的转义。

11. 内嵌 HTML 标签

对于 Markdown 涵盖范围之外的标签，都可以直接在文件里面用 HTML 本身。 如需使用 HTML，不需要额外标注这是 HTML 或是 Markdown，只需 HTML 标签添加到 Markdown 文本中即可。

（没有了解过HTML的读者可以先跳过这一点）

11.1 行级内联标签

行内（内联）标签是HTML中的元素，可以在Markdown的段落、列表或标题中自由使用。根据个人偏好，甚至可以完全不使用Markdown格式，而直接使用HTML标签进行格式化。例如，如果更喜欢HTML的<strong>或<em>标签，可以直接使用这些标签，而不使用Markdown提供的加粗或斜体语法。当需要修改元素的属性时（例如为文本指定颜色或更改图像的宽度），使用HTML标签更方便。

HTML行内标签与块级标签不同，在行内标签的范围内，Markdown语法是可以解析的。

This **word** is bold. This <em>word</em> is italic.

渲染效果如下所示：

This word is bold. This word is italic.

11.2 区块标签

区块标签（块级元素）如<div>、<table>、<pre>和<p>等标签，必须在前后加上空行，以便于将其内容与其他内容区分开。此外，在区块标签的开始和结束标签之间不能使用制表符或空格进行缩进。Markdown会自动识别这些区块元素，避免在区块标签前后添加不必要的段落标签。

例如，在Markdown文件中插入一个HTML表格的示例：

This is a regular paragraph.

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

This is another regular paragraph.

请注意，Markdown语法在HTML区块标签中将不会被处理。例如，无法在HTML区块中使用Markdown形式的强调或其他语法。

总结来说，行内标签可以在Markdown中直接使用，并与Markdown语法一起解析，而区块标签需要在前后加上空行，并且Markdown不会对区块标签中的内容进行处理。

四. Markdown的扩展语法

至此，你已经学习完了所有的基础语法，已经能够应付大多数情况下的日常所需元素，但对于某些人来说还不够，这就是扩展语法的用武之地。

一些个人和组织开始通过添加其他元素（例如表，代码块，语法突出显示，URL自动链接和脚注）来扩展基本语法。 可以通过使用基于基本Markdown语法的轻量级标记语言，或通过向兼容的Markdown处理器添加扩展来启用这些元素。

1. 表格

| 列1标题 | 列2标题 | 列3标题 |
| ------ | ------ | ------ |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

在表格的第一行中，使用|分隔不同的列，并在每列中写入列标题。第二行使用------定义表头与表格内容之间的分隔线。接下来的行中，每个单元格的内容使用|分隔，对应到相应的列。

例如，下面是一个简单的表格示例：

| 姓名   | 年龄 | 性别 |
| ------ | ---- | ---- |
| 张三   | 25   | 男   |
| 李四   | 30   | 女   |
| 王五   | 28   | 男   |

渲染效果如下所示：

姓名年龄性别
张三25男
李四30女
王五28男

Tip: 使用连字符和管道创建表可能很麻烦。 为了加快该过程，请尝试使用Markdown Tables Generator。 使用图形界面构建表，然后将生成的Markdown格式的文本复制到文件中。

1.1 对齐

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

| 姓名   | 年龄 | 性别 |
| :---- | :---- | :---- |
| 张三   | 25   | 男   |
| 李四   | 30   | 女   |
| 王五   | 28   | 男   |

渲染效果如下所示：

姓名年龄性别
张三25男
李四30女
王五28男

1.2 格式化表格中的文字

您可以在表格中设置文本格式可以使用以下内容：

  • **普通文本：**可以在表格的单元格中放置普通的文本内容。
  • **链接：**可以使用链接语法将文本转换为链接。
  • **内联代码：**可以使用反引号（`）将单词或短语表示为内联代码。
  • **强调：可以使用加粗（）或斜体（*）语法来强调文本。
  • **HTML字符代码：**可以使用HTML字符代码来显示特殊字符，如竖线（|）。

以下内容不能在Markdown表格中使用：

  • **标题：**Markdown表格不支持在单元格中使用标题语法（例如，#）。
  • **块引用：**Markdown表格不支持在单元格中使用块引用语法（例如，>）。
  • **列表：**Markdown表格不支持在单元格中使用列表语法（例如，- 或 1.）。
  • **水平规则：**Markdown表格不支持在单元格中使用水平规则语法（例如，---）。
  • **图像：**Markdown表格不支持在单元格中直接插入图像。
  • **HTML标签：**Markdown表格不会解析或处理在单元格中使用的HTML标签。
可以在表格中使用不能在表格中使用
普通文本标题
链接块引用
内联代码列表
强调水平规则
| 竖线字符图像
HTML标签

1.3 在表中转义管道字符

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

2. 围栏代码块

围栏代码块是用于显示多行代码或程序代码片段的常用语法。围栏代码块通过在代码块前后使用三个连续的反引号（```)来定义。

以下是围栏代码块的示例：

`````语言 代码块内容 `````

在这个示例中，您需要将"语言"替换为实际的编程语言，以便代码块能够正确地进行语法高亮显示。如果不需要语法高亮，可以将"语言"部分省略。

下面是一个具体的示例，展示了如何使用围栏代码块：

def greet(name):
    print("Hello, " + name + "!")

greet("World")

3. 降价脚注

降价脚注是一种在文本中添加注释或补充说明的方式。它通常以数字或符号的形式出现在文本的底部，并与相应的注释内容相关联。降价脚注用于提供额外的信息，解释或引用来源，以避免在正文中打断流畅的阅读体验。

这是一段文本，需要添加降价脚注[^1]。在文末的附注部分，可以找到与降价脚注相关的详细说明。

[^1]: 这是降价脚注的详细说明。它提供了额外的信息或引用的来源。

渲染效果如下所示：

这是一段文本，需要添加降价脚注1。在文末的附注部分，可以找到与降价脚注相关的详细说明。

降价脚注出现在文章最后

4. 定义列表

Markdown中的定义列表是一种用于表示定义、解释或描述的文本结构。它由术语（或术语列表）和对应的定义（或描述）组成。

第一术语
: 这是第一个术语的定义。

第二术语
: 这是第二个术语的一个定义。
: 这是第二个术语的另一个定义。

HTML看起来像这样：

<dl>
  <dt>First Term</dt>
  <dd>This is the definition of the first term.</dd>
  <dt>Second Term</dt>
  <dd>This is one definition of the second term. </dd>
  <dd>This is another definition of the second term.</dd>
</dl>

渲染效果如下所示：

First Term
This is the definition of the first term.
Second Term
This is one definition of the second term.
This is another definition of the second term.

(这些其实都是HTML的基础知识)

5. 删除线

可以使用双波浪线（~~）将文本标记为删除线

~~删除线~~

渲染效果如下所示：

删除线

6. 任务列表

Markdown中的任务列表语法允许您创建具有复选框的任务列表。这对于跟踪任务、制定计划或记录待办事项非常有用。

任务列表由一对方括号[]和空格组成，可以用于表示已完成或未完成的任务。下面是任务列表的语法示例：

- [ ] 未完成任务
- [x] 已完成任务

渲染效果如下所示：

  • 未完成任务
  • 已完成任务

7. 表情符号面部表情

  1. 使用Unicode代码点：可以使用Emoji的Unicode代码点（例如，U+1F600）来插入表情。例如，“:grinning:” 表示笑脸表情。
  2. 使用Emoji的简短标识符：可以使用Emoji的简短标识符（例如，:smile:）来插入表情。通过在冒号（:）之间输入相应的表情标识符，例如 “😄” 表示笑脸表情。
我今天感觉很开心！:smile:

渲染效果如下所示：

我今天感觉很开心！😄

具体可以已此网站 [标签符号简码列表](Complete list of github markdown emoji markup) 作为参考

8. 自动网址链接

许多Markdown处理器会自动将URL转换为链接。 这意味着如果您输入http://www.example.com，即使您未使用方括号，您的Markdown处理器也会自动将其转换为链接。

渲染效果如下所示：

http://www.example.com

如果您不希望自动链接URL，则可以通过将URL表示为带反引号的代码来删除该链接

渲染效果如下所示：

http://www.example.com

五. 结语

现在你已经掌握了Markdown语法的基础知识，你可以用它来创建格式丰富的文档、博客和笔记。Markdown简单而直观的语法使得它成为一种流行的文本标记语言。希望本篇博客能够为你提供了对Markdown语法的全面了解。

如果你对Markdown感兴趣并希望深入学习，以下是一些推荐的资源：

  • Markdown Guide：一个详尽的Markdown语法指南和参考，提供丰富的示例和解释。它涵盖了Markdown的所有基本语法，以及更高级的用法和扩展。
  • Typora：一款简洁而强大的Markdown编辑器，提供实时预览和丰富的编辑功能。它为你的Markdown写作提供了更直观和高效的体验。
  • Markdown 教程 | 菜鸟教程 and Markdown 官方教程：同样提供了关于Markdown语法的详细介绍和示例，更好的点是这是中文的

感谢你花时间阅读本篇关于Markdown语法的博客。希望这篇博客对你有所帮助，让你更好地利用Markdown来创建优雅、格式一致的文档。如果你有任何问题、建议或者想要分享你的Markdown经验，请在下方留下评论，我很乐意与你互动和交流。

  1. 这是降价脚注的详细说明。它提供了额外的信息或引用的来源。 ↩︎

努力Study的小陈
关注
专栏目录
Markdown--从入门到精通(md源文件)
damon_yan的专栏
06-14 2009
####导语: >[Markdown](http://zh.wikipedia.org/wiki/Markdown)是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需
Markdown【从入门到精通简单易学就够了】
最新发布
weixin_42180610的博客
08-08 520
Markdown 是非常厉害的，但是我认为它建立的初衷是为了方便大家记笔记写博客，它具有很强大的功能，例如流程图、复杂的公式呈现，虽然看起来很有用，但是我认为这些功能与它创立的初衷是违背的，而且做流程图和复杂的公式是有专门的工具，而且十分便捷。实则不然，Markdown的语言非常非常简单，如果想学，10分钟你完全可以学完90%的常用的语法，而且你从此摆脱排版的折磨，属实是强迫症党的福利了。如果是在一个块内需要引用代码，则在需要引用的代码块的前一行和后一行使用三个反引号，同时在前一个反引号后写入代码的语言。
Markdown--从入门到精通
ahoo110的博客
06-03 1112
Markdown–从入门到精通导语 [markDown–汉语语法] (http://www.appinn.com/markdown/) [wiki–markDown 语法] (https://en.wikipedia.org/wiki/Markdown#Example) 一、认识我的文档 1编序号 2引用 3图片、链接 4粗体、斜体 5表格 6代码 7分割线 编序号无序 你就是我的唯一
Markdown从入门到精通（+软件推荐）
qq_30615227的博客
10-18 9101
总览 几乎所有 Markdown 应用程序都支持 John Gruber 原始设计文档中列出的 Markdown 基本语法。但是，Markdown 处理程序之间存在着细微的变化和差异，我们都会尽可能标记出来。 标题（Headings） 要创建标题，请在单词或短语前面添加井号 (#) 。井号的数量代表了标题的级别。例如，添加三个井号即创建一个三级标题 (<h3>) (例如：### My Header)。 Markdown 是什么？ Markdown 是一种轻量级的标记语言，
轻松掌握Markdown：从入门到精通的全面指导.txt
01-22
markdown
springboot从入门到精通 markdown文件 总结
04-10
3. **内嵌式容器**：Spring Boot 支持内嵌式 Tomcat、Jetty 或 Undertow，无需额外部署应用到外部服务器。 4. **Actuator**：提供了一组端点来监控和管理应用程序，包括健康检查、环境信息、指标等。 5. **无 XML ...
算法之旅：从入门到精通-markdown材料.zip
08-07
算法之旅：从入门到精通，acm比赛基础，算法思维提升
AndroidStudio教程从入门到精通.[汇编].pdf
10-19
开发者通常会从入门者逐渐成长为高级开发者，通过学习文档、观看教学视频、参与社区讨论和实际开发项目，逐步掌握Android Studio的高级功能，例如性能优化、多屏幕适配、应用安全等。 ### 总结 以上内容覆盖了...
【YOLO开发实战】：从入门到精通的深度学习之旅-Markdown文章材料.zip
06-13
探索深度学习的奥秘，掌握目标检测的尖端技术，现在有了全新的学习指南——《YOLO开发实战：从入门到精通》Markdown文章材料。 这份资料从YOLO（You Only Look Once）算法的基础知识讲起，深入浅出地介绍了目标检测...
洛谷 Markdown - 从入门到精通
Jerrycyx的博客
09-06 2111
希望更丰富的展现？使用 Markdown。 这是洛谷文字编辑时会出现的一行文字。这是你可能会疑惑：Markdown 是什么？为什么洛谷的文字编辑区如此奇怪？ 本文将为你揭开这些问题，并使你短时间精通 Markdown。 什么是 Markdown? Markdown 是一种轻量级标记语言。 什么意思呢？就是说，你需要写下一段内容（【源代码】），然后洛谷会自动帮你渲染这段内容。 举个例子你就明白了： 比方说你输入的是 _Haha_（两侧带下划线），那么洛谷就会帮你渲染成 Haha （变成斜体）。
手把手教会你使用Markdown【从入门到精通一篇就够了】
指尖动听知识库
07-09 251
大家好，我是卷不动的小白，如名我可能和大部分人一样是个什么都要学习的小白，当自己潜下心来要记笔记写博客的时候接触到了Markdown语法。Markdown 是一种轻量级标记语言，通俗的说你记笔记写博客的时候不用管排版如何，只要将自己的内容写上去，Markdown语法就可以给你搞定一切。
Markdown 语法总结【从入门到精通一篇就够了】
小北的博客
01-12 1210
Markdown 语法总结【从入门到精通一篇就够了】这篇文章 在这里，我想分享一下，这篇文章从整理到最后的完稿，花费了好多天的心血和努力。有时候确实会想要偷懒，不想再写下去，但是每当看到过去的文章受到大家的关注、点赞、以及收藏，就仿佛得到了一种强大的动力。你们的支持是我坚持写作的动力源泉。我不敢说这篇文章写得最好，但我敢说，我尽可能做到了最全面。
Atom编辑器入门到精通(六) Markdown支持
u010494080的专栏
09-09 7709
尽管我们使用Atom主要是为了编写代码,不过Atom还支持编辑很多其他格式的文件. 比如Markdown和Asciidoc. 这一章中我们主要学习如何快速方便地编辑Markdown文件.
.md即markdown文件的基本常用编写语法（图文并茂）
weixin_30788731的博客
01-21 8727
序言: 很久没有写博客了，感觉只要是不写博客，人就很变得很懒，学的知识点感觉还是记不住，渐渐地让我明白，看的越多，懂的越少（你这话不是有毛病吗？应该是看的越多，懂的越多才对），此话怎讲，当你在茫茫的前端知识库里面东看看，西看看的时候，很快就被海量的知识给淹没了，根本就不知道哪些是对的，哪些是错的，感觉好像这个也懂了，那个也懂了，但是真正写起来，脑子又一片空白，又好像什么都不懂，这种状态...
Markdown基础知识教程：从入门到精通
Markdown的广泛应用在于编写电子书、博客文章、README文件等，其语法简洁且直观，使得非程序员也能轻松上手。 在Markdown学习中，以下是一些关键知识点： 1. **标题**：Markdown使用#号来创建不同级别的标题。例如...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值