Markdown从入门到精通

超全面的Markdown语法

  • 一.什么是 MarkDown
  • 二.为什么要使用Markdown
  • 三.Markdown的基础语法
    • 1. 标题语法
      • 1.1 可选语法
      • 1.2 标题的最佳实践
    • 2. 段落语法
      • 2.1 段落的最佳实践
    • 3. 强调语法
      • 3.1 斜体(Italic)
      • 3.2 粗体(Bold)
      • 3.3 强调语法的最佳实践
    • 4. 引用语法
      • 4.1 多个段落的块引用
      • 4.2 嵌套块引用
      • 4.3 带有其它元素的块引用
    • 5. 列表语法
      • 5.1 有序列表
      • 5.2 有序列表最佳实践
      • 5.3 无序列表
      • 5.4 无序列表最佳实践
      • 5.5 在列表中嵌套其他元素
        • 5.5.1 段落
        • 5.5.2 引用块
        • 5.5.3 代码块
        • 5.5.4 图片
        • 5.5.5 列表
    • 6. 代码语法
      • 6.1 转义反引号
      • 6.2 代码块
    • 7. 分隔线语法
      • 7.1 分隔线的最佳实践
    • 8. 链接语法
      • 8.1 给链接增加 Title
      • 8.2 网址和Email地址
      • 8.3 带格式化的链接
      • 8.4 引用类型链接
      • 8.5 链接的最佳实践
    • 9. 图片语法
      • 9.1 链接图片
    • 10. 转义字符语法
      • 10.1 可做转义的字符
      • 10.2 特殊字符自动转义
    • 11. 内嵌 HTML 标签
      • 11.1 行级内联标签
      • 11.2 区块标签
  • 四. Markdown的扩展语法
    • 1. 表格
      • 1.1 对齐
      • 1.2 格式化表格中的文字
      • 1.3 在表中转义管道字符
    • 2. 围栏代码块
    • 3. 降价脚注
    • 4. 定义列表
    • 5. 删除线
    • 6. 任务列表
    • 7. 表情符号面部表情
    • 8. 自动网址链接
  • 五. 结语

一.什么是 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 itemdef example_function():print("This is an example")- Second item```pythondef 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.ChatGPT3. 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://img-blog.csdnimg.cn/9014a4ec2234428587f0c160e11e4c73.png)

这是一张图片

9.1 链接图片

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

[![一张图片](https://img-blog.csdnimg.cn/0fa365962eeb4ca585b75a95ed3046ee.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. 这是降价脚注的详细说明。它提供了额外的信息或引用的来源。 ↩︎

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.rhkb.cn/news/38359.html

如若内容造成侵权/违法违规/事实不符,请联系长河编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

爬取最新斗图啦网站上表情包

女朋友找我斗图&#xff0c;最后斗她到自闭。 网址&#xff1a;https://www.doutula.com/ 难度不大&#xff0c;代码如下&#xff1a; # -*- coding: utf-8 -*-import random import requests from bs4 import BeautifulSoup import urllib import osBASE_URL https://www.…

表情包AI生成器:识别人脸情绪,自动配文字

梅宁航 发自 凹非寺 量子位 报道 | 公众号 QbitAI Meme表情包&#xff0c;兴盛于各大社交网站&#xff0c;但自己动手制作费时耗力。 “急民之所急”&#xff0c;表情包自动生成器出现了。 以往的此类生成器&#xff0c;只是简单的图片配文字&#xff0c;总觉得有点文不对题。 …

获取、导出微信所有表情

前言 适用&#xff1a;PC端微信 2.6.8.51版本 发布于2019年8月25日 本文仅作技术研究 一直在想微信收藏的表情包为什么不能右键另存为到本地 像QQ一样多好&#xff0c;有时候想把微信的表情导入到QQ里面用也不行&#xff0c;多不方便 百度查了一下&#xff0c;都是找CustomE…

怎么制作微信表情包?这两种方法,亲测好用

分享两种微信表情包制作方法&#xff0c;一种是用微信自带的表情包制作工具&#xff0c;另一种是将视频转换成GIF表情包。 一、微信小程序自制 1.首先我们打开微信&#xff0c;点击底部的【发现】&#xff0c;进入【小程序】界面&#xff0c;在上方的搜索框里输入“微信创意表…

Python爬虫爬取表情包+Autojs微信自动导入表情包脚本(附源码)

废话不多说直接开始 Python爬取表情包 一、检查网页源码 发现可以找到图片地址&#xff0c;直接请求图片地址下载图片 二、打开开发者工具(F12) 通过xpath提取p标签下的img标签src属性为图片地址 三、编写程序 代码 import requests from fake_useragent import U…

表情识别/情绪识别:ExpW表情数据集

ExpW表情数据集 1、数据集介绍2、数据集处理3、数据集下载 1、数据集介绍 论文《Deep Facial Expression Recognition: A Survey》里对其进行了介绍&#xff1a; ExpW [47]: The Expression in-the-Wild Database (ExpW) contains 91,793 faces downloaded using Google imag…

基于文字识别与情感语义分析的(熊猫头)Emoji表情包搜索神器 —— 可以识别本地表情包或者爬取网络表情包

AI Sticker Searcher 目录 generated with DocToc AI Sticker Searcher&#x1f303; 最新版本✨ 开始 1️⃣ 直接搜索表情包2️⃣ 本地没有表情包&#xff0c;想要爬取点表情包上传到云端识别搜索3️⃣ 当你本地有很多表情包图片&#xff0c;想要识别时4️⃣ 觉得云端搜索太慢…

获取千牛聊天对象(聊天记录中获取)

根据上一篇 获取千牛聊天记录 我们只要解析一下聊天记录的html就可以获取到聊天对象了。 先看实现效果吧实现原理就是在窗体中加了个Timer(定时器控件)定时获取html并解析就能获取到聊天对象了 但是有个问题,就是没有聊天记录的就获取不到了.... 这个问题留着下一篇解决吧.... …

旺旺打标工具,淘宝搜索打标软件(含旺旺打标API接口)

一、【旺旺打标工具,淘宝搜索打标软件】实现需求 指定的单品将会出现在手淘搜索首屏位置及淘内所有免fei流量入口位置。 二、【淘宝搜索打标】应用场景   使用淘宝搜索打标工具后,将宝贝推送到搜索页。 旺旺打标api接口返回示例&#xff1a; {"msg": "succe…

千牛卖家工作平台使用教程

千牛电脑版(卖家工作台) 1.13.19 免费版 千牛官方下载,千牛卖家版官方下载,千牛工作台,千牛卖家移动工作平台 让卖家可以更加便捷和高效的管理店铺&#xff0c;让生意游刃有余。千牛&#xff0c;为阿里巴巴官方出品的卖家一站式工作台&#xff0c;其核心是为卖家整合&#xff1…

淘宝千牛软件服务器fmsas端口与客户端的通信协议(完整版)

个人兴趣学习&#xff0c;不负法律责任 本例纯属学习和科研参考&#xff0c;请勿用在商务用途&#xff08;使用淘宝开放平台的api吧~~by凉 白开QQ&#xff09;。 前言&#xff1a; 帮朋友的过程中&#xff0c;突然想到一个像淘宝这样安全性这么强的互联网企业&#xff08;额&…

如果鸿蒙系统上线,使用体验与安卓相当,你会换系统么?

其实这个我觉得不是你会不会换的问题&#xff0c;而是华为如果给了很多手机装了鸿蒙系统&#xff0c;而且还保持了目前的UI使用体验&#xff0c;同时也能做到了底层优化的技术&#xff0c;让速度快&#xff0c;为何不用&#xff1f;其实目前在国产基本上没有谷歌的安卓原生态系…

鸿蒙(harmonyOS)应用开发-真机设备API版本查看

如何使用hdc工具查看鸿蒙真机版本 前言 在鸿蒙应用开发中&#xff0c;我们会在真机上进行调试&#xff0c;但是我们需要保证我们选择的API版本大于或等于手机的API版本&#xff0c;否则可能会出现兼容性问题。那么&#xff0c;如何查看真机的API版本呢&#xff1f;本文将介绍…

『牛角书』HarmonyOS鸿蒙实战 开发一个简单聊天助手APP

前言 我是通过b站上面老师的讲解&#xff0c;跟着老师编写了一个简单聊天助手app&#xff0c;简答实用&#xff0c;对于刚开始接触鸿蒙的我们来说很有帮助。 创建项目 所用软件为DevEco Studio&#xff0c;点击Create HarmonyOS Project&#xff0c;这里选择了第一个空的项目…

开发跨设备的鸿蒙(HarmonyOS) App

为了让更多的人看到本文&#xff0c;请各位读者动动小手&#xff0c;点击右上角【...】&#xff0c;将本文分享到朋友圈&#xff0c;thanks&#xff01; 现在的智能设备种类越来越多&#xff0c;而且这些智能设备的屏幕尺寸、分辨率都不同&#xff0c;例如&#xff0c;比较常见…

鸿蒙系统vivo能用吗,不是华为手机,也能用上鸿蒙系统

按照此前的进度&#xff0c;华为的鸿蒙 OS 系统已经在 Mate40 等多款华为系手机上小范围推送&#xff0c;从此前公布的消息来看&#xff0c;应该在 6 月份正式全面开放&#xff0c;让更多的用户用上这套华为自研的系统。 今天&#xff0c;华为召开了一场鸿蒙 OS 的合作伙伴峰会…

终于有人把鸿蒙OS讲明白了!并开放鸿蒙教程!

点击“开发者技术前线”&#xff0c;选择“星标????” 让一部分开发者看到未来 “ 本文面向的是开发人员&#xff0c;主要想通过科普让大家了解一下鸿蒙开发。接下来&#xff0c;我想给大家科普一下这个这么火的鸿蒙系统。 到底什么是鸿蒙 OS 在官网上看到鸿蒙 OS 的简介是…

不要总想着自己训练大模型,你的业务可能并不需要

至少企业知识库是这样。 我要训练大模型&#xff0c;我要做私有部署&#xff0c;我要做模型 Fine-tune&#xff0c;我要搞垂类 GPT。最近真是听了好多这样的话&#xff0c;让我想起之前刷到的一个视频&#xff1a; 我长大要开飞机&#xff0c;我想当宇航员&#xff0c;我要有所…

别光骂谷歌了!新版 Bing 花式“翻车”,还让用户向它道歉?

整理 | 郑丽媛 出品 | CSDN&#xff08;ID&#xff1a;CSDNnews&#xff09; 因为 ChatGPT&#xff0c;最近谷歌被“黑”得挺惨&#xff1a;先是它发布的 ChatGPT 竞品 Bard 全球首秀“大翻车”&#xff0c;导致谷歌市值一夜狂跌 7000 亿&#xff1b;接着又被自家员工嘲讽&…

4大主流小程序平台介绍及其优缺点对比

文章目录 人工智能福利文章微信小程序优点缺点 支付宝小程序优点缺点&#xff1a; 百度小程序优点缺点 字节小程序优点缺点 总结写在最后 ✍创作者&#xff1a;全栈弄潮儿 &#x1f3e1; 个人主页&#xff1a; 全栈弄潮儿的个人主页 &#x1f3d9;️ 个人社区&#xff0c;欢迎你…