基本到扩展的Markdown速查表与示例

Markdown扩展速查表与示例

Markdown是一种广泛使用的标准,用特殊语法分发文本文件,现代软件可以轻松理解和格式化,无需编写整个HTML代码。

将其视为一种在文本文档中以简单易读的方式添加HTML样式和结构的方法,没有编码经验的人可以轻松理解和记住。

例如,通过在相应行的开头放置“”,就像这样“#标题1”,它将被解释为HTML格式中的“<h1>标题1</h1>”,要实现这一点,您只需使用“.md”扩展名保存您的文件。

由于其简单性,GitHub上几乎所有README文件都是命名为“README.md”的Markdown文件。广泛使用的静态站点生成器Hugo默认也使用它用于帖子和页面,在WordPress块编辑器中,您可以使用它立即生成特定元素。

因此,难怪如果您有IT背景或偶尔与程序进行交互,您必须立即学习阅读和编写Markdown文件!

如何阅读和编写Markdown文件(速查表) #

要阅读和编写Markdown文件,您必须对其中使用的特殊语法有基本的理解。您可以参考以下速查表(或示例)来达到这个目的。

📝

以下是广泛使用的原生支持的语法;除此之外的任何内容都是专门设计的语法,只能由特殊处理器处理。

  1. 声明HTML标题的语法。
# 标题1

## 标题2

### 标题3

#### 标题4

##### 标题5

###### 标题6

解释为:

![在Markdown文件中编写HTML标题](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjQzNCIgdmlld0JveD0iMCAwIDEwMjQgNDM0Ij48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)

  1. 粗体和斜体文本样式的语法。

📝

遗憾的是,在Markdown文件中为文本添加下划线是不可能的,因为它也被表示为链接。

**粗体文本**

*斜体文本*

解释为:

![在Markdown文件中样式化文本](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4ODYiIGhlaWdodD0iMTUxIiB2aWV3Qm94PSIwIDAgODg2IDE1MSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

  1. 创建引用块和嵌套引用块的语法。
> 单引用块

> 引用块
>> 嵌套引用块

解释为:

![在Markdown文件中的引用块](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4ODciIGhlaWdodD0iMTk2IiB2aWV3Qm94PSIwIDAgODg3IDE5NiI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

  1. 创建水平线(或分隔线)的语法。
# 以下是三个破折号来创建水平线。
---
lorem ipsum

解释为:

![在Markdown文件中添加分隔符](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE2NiIgdmlld0JveD0iMCAwIDEwMjQgMTY2Ij48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)

  1. 创建有序和无序列表的语法。
# 有序列表

1. 第一项
2. 第二项
3. 第三项

# 无序列表

- 第一项
- 第二项
- 第三项

解释为:

![在Markdown文件中创建有序和无序列表](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5ODkiIGhlaWdodD0iNDYxIiB2aWV3Qm94PSIwIDAgOTg5IDQ2MSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

  1. 创建代码块的语法。
`$ echo "Linux TLDR是一个学习Linux的好网站。"`

解释为:

![在Markdown文件中创建代码块](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5MzciIGhlaWdodD0iODciIHZpZXdCb3g9IjAgMCA5MzcgODciPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIHN0eWxlPSJmaWxsOiNjZmQ0ZGI7ZmlsbC1vcGFjaXR5OiAwLjE7Ii8+PC9zdmc+)

  1. 添加(或插入)链接的语法。

📝

遗憾的是,在Markdown文件中,无法指定HTML文件中使用的“<a>”标签,例如“target”和“rel“。

[标题](https://www.example.com)

[Linux TLDR](https://www.linuxtldr.com)

解释为:

![在Markdown文件中插入链接](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE0NyIgdmlld0JveD0iMCAwIDEwMjQIDE0NyIj48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)

  1. 添加(或插入)图像的语法。
![替代文本](image.jpg)

解释为:

![在Markdown文件中插入图像](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5MTUiIGhlaWdodD0iMjM1IiB2aWV3Qm94PSIwIDAgOTE1IDIzNSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

  1. 在图像中包含链接的语法。
[![标题](image.jpg "图像替代文本")](https://linuxtldr.com)

解释为:

![在Markdown文件中在图像内插入链接](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5MTUiIGhlaWdodD0iMjM1IiB2aWV3Qm94PSIwIDAgOTE1IDIzNSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

因此,这里结束了Markdown文件中使用的基本语法。现在,您可能会认为列表中的语法非常有限,不幸的是这是事实。

现在,有一些扩展语法提供了一些附加功能,并且幸运的是,它们在流行的应用程序(如Hugo或GitHub)中都受到支持。

要了解更多信息,请查看以下示例,继续我们之前的基本语法。

  1. 创建表格的语法。
| 编号          | 人员         | 年龄        | 
| ----------- | ----------- | ----------- |
| 01          | 克里斯       | 36          |
| 02          | 丹尼斯      | 25          |
| 03          | 大卫       | 24          |
| 04          | 托马斯      | 47          |

解释为:

![在Markdown文件中创建表格](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4MDgiIGhlaWdodD0iMjc5IiB2aWV3Qm94PSIwIDAgODA4IDI3OSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

  1. 定义围栏(或多行)代码块的语法。

$ echo "这是第一句话" $ echo "这是第二句话" $ echo "这是第三句话"

解释为:

![在Markdown文件中创建围栏代码块](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4NTUiIGhlaWdodD0iMTYyIiB2aWV3Qm94PSIwIDAgODU1IDE2MiI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

  1. 创建标题ID和重定向链接的语法。

### 标题01 {#ref-h1-id}

lorem ipsum

[重定向至标题01](#ref-h1-id)

解释为:

![在Markdown文件中创建标题ID](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5MTUiIGhlaWdodD0iMjM1IiB2aWV3Qm94PSIwIDAgOTE1IDIzNSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=) 13. 创建脚注的语法。

📝

脚注是创建注释并添加引用的一种方式,用户可以通过点击并被重定向到创建的注释。

这是带有脚注的句子。[^1]

乱数

[^1]: 这是脚注。

解释为:

![在Markdown文件中创建脚注](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE4MSIgdmlld0JveD0iMCAwIDEwMjQgMTgxIj48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)

  1. 创建定义列表的语法。
term
: definition

---

Linux TLDR
: 欢迎来到Linux TLDR,您掌握Linux世界的最终目的地!我们热爱开源技术,致力于为您提供最新的新闻、教程、技巧和资源,帮助您精通Linux和开源软件的世界。

解释为:

![在Markdown文件中创建定义列表](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjIzNSIgdmlld0JveD0iMCAwIDEwMjQgMjM1Ij48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)

以上输出可能无法解释此语法的行为,因此以下是上述输出的HTML代码输出,通过向Markdown文件添加定义标签来说明其工作原理。

<dl>
    <dt>term</dt>
    <dd>definition</dd>
</dl>

<hr>

<dl>
    <dt>Linux TLDR</dt>
    <dd>欢迎来到Linux TLDR,您掌握Linux世界的最终目的地!我们热爱开源技术,致力于为您提供最新的新闻、教程、技巧和资源,帮助您精通Linux和开源软件的世界。</dd>
</dl>
  1. 给文本加上删除线的语法。
~~猫咪从不咬人~~

解释为:

![在Markdown文件中给文本加上删除线](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI3OTAiIGhlaWdodD0iMTI4IiB2aWV3Qm94PSIwIDAgNzkwIDEyOCI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

  1. 创建任务列表的语法。

📝

任务无法与后端服务器一起工作,但这是一种展示特定工作进度或提供状态更新的好方法。

- [x] 项目蓝图
- [x] 项目设计
- [ ] 预算分配

解释为:

![在Markdown文件中创建任务列表](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE3MSIgdmlld0JveD0iMCAwIDEwMjQgMTcxIj48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)

  1. 通过复制粘贴或短代码添加表情符号。

📝

您可以通过两种不同的方式向Markdown文件添加表情符号:第一种是直接从表情符号提供站点(如Emojipedia (opens new window))复制粘贴,或者使用表情符号短代码(获取列表 (opens new window))。


## 猫咪对鱼缸说了什么?

你今天看起来鱼-棒极了! :laughing:

解释为:

![在Markdown文件中添加表情符号](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE2MyIgdmlld0JveD0iMCAwIDEwMjQgMTYzIj48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)

  1. 禁用自动URL链接的语法。
自动URL链接
//www.linuxtldr.com

禁用自动URL链接
`//www.linuxtldr.com`

解释为:

![在Markdown文件中禁用自动URL链接](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE0NSIgdmlld0JveD0iMCAwIDEwMjQgMTQ1Ij48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)

  1. 给文本添加高亮的语法。
在Linux世界中,==Linux TLDR== 将是最好的网站。

解释为:

![在Markdown文件中给文本添加高亮](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4NDEiIGhlaWdodD0iMTAzIiB2aWV3Qm94PSIwIDAgODQxIDEwMyI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

  1. 指定下标和上标。
C~2~H~3~O~2~NH~4~
X^3^Y^6^

解释为:

![在Markdown文件中添加下标和上标](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4MzkiIGhlaWdodD0iMTMyIiB2aWV3Qm94PSIwIDAgODM5IDEzMiI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)

这里是Markdown文件中扩展语法列表的结尾。现在,如果您对它们感兴趣并想要练习,应该如何做呢?让我们在下一节中找出答案。