Markdown扩展速查表与示例
Markdown是一种广泛使用的标准,用特殊语法分发文本文件,现代软件可以轻松理解和格式化,无需编写整个HTML代码。
将其视为一种在文本文档中以简单易读的方式添加HTML样式和结构的方法,没有编码经验的人可以轻松理解和记住。
例如,通过在相应行的开头放置“#
”,就像这样“#标题1
”,它将被解释为HTML格式中的“<h1>标题1</h1>
”,要实现这一点,您只需使用“.md
”扩展名保存您的文件。
由于其简单性,GitHub上几乎所有README文件都是命名为“README.md
”的Markdown文件。广泛使用的静态站点生成器Hugo默认也使用它用于帖子和页面,在WordPress块编辑器中,您可以使用它立即生成特定元素。
因此,难怪如果您有IT背景或偶尔与程序进行交互,您必须立即学习阅读和编写Markdown文件!
如何阅读和编写Markdown文件(速查表) #
要阅读和编写Markdown文件,您必须对其中使用的特殊语法有基本的理解。您可以参考以下速查表(或示例)来达到这个目的。
📝
以下是广泛使用的原生支持的语法;除此之外的任何内容都是专门设计的语法,只能由特殊处理器处理。
- 声明HTML标题的语法。
# 标题1
## 标题2
### 标题3
#### 标题4
##### 标题5
###### 标题6
解释为:
![在Markdown文件中编写HTML标题](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjQzNCIgdmlld0JveD0iMCAwIDEwMjQgNDM0Ij48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)
- 粗体和斜体文本样式的语法。
📝
遗憾的是,在Markdown文件中为文本添加下划线是不可能的,因为它也被表示为链接。
**粗体文本**
*斜体文本*
解释为:
![在Markdown文件中样式化文本](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4ODYiIGhlaWdodD0iMTUxIiB2aWV3Qm94PSIwIDAgODg2IDE1MSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
- 创建引用块和嵌套引用块的语法。
> 单引用块
> 引用块
>> 嵌套引用块
解释为:
![在Markdown文件中的引用块](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4ODciIGhlaWdodD0iMTk2IiB2aWV3Qm94PSIwIDAgODg3IDE5NiI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
- 创建水平线(或分隔线)的语法。
# 以下是三个破折号来创建水平线。
---
lorem ipsum
解释为:
![在Markdown文件中添加分隔符](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE2NiIgdmlld0JveD0iMCAwIDEwMjQgMTY2Ij48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)
- 创建有序和无序列表的语法。
# 有序列表
1. 第一项
2. 第二项
3. 第三项
# 无序列表
- 第一项
- 第二项
- 第三项
解释为:
![在Markdown文件中创建有序和无序列表](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5ODkiIGhlaWdodD0iNDYxIiB2aWV3Qm94PSIwIDAgOTg5IDQ2MSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
- 创建代码块的语法。
`$ echo "Linux TLDR是一个学习Linux的好网站。"`
解释为:
![在Markdown文件中创建代码块](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5MzciIGhlaWdodD0iODciIHZpZXdCb3g9IjAgMCA5MzcgODciPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIHN0eWxlPSJmaWxsOiNjZmQ0ZGI7ZmlsbC1vcGFjaXR5OiAwLjE7Ii8+PC9zdmc+)
- 添加(或插入)链接的语法。
📝
遗憾的是,在Markdown文件中,无法指定HTML文件中使用的“<a>
”标签,例如“target
”和“rel
“。
[标题](https://www.example.com)
[Linux TLDR](https://www.linuxtldr.com)
解释为:
![在Markdown文件中插入链接](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE0NyIgdmlld0JveD0iMCAwIDEwMjQIDE0NyIj48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)
- 添加(或插入)图像的语法。
![替代文本](image.jpg)
解释为:
![在Markdown文件中插入图像](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5MTUiIGhlaWdodD0iMjM1IiB2aWV3Qm94PSIwIDAgOTE1IDIzNSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
- 在图像中包含链接的语法。
[![标题](image.jpg "图像替代文本")](https://linuxtldr.com)
解释为:
![在Markdown文件中在图像内插入链接](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI5MTUiIGhlaWdodD0iMjM1IiB2aWV3Qm94PSIwIDAgOTE1IDIzNSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
因此,这里结束了Markdown文件中使用的基本语法。现在,您可能会认为列表中的语法非常有限,不幸的是这是事实。
现在,有一些扩展语法提供了一些附加功能,并且幸运的是,它们在流行的应用程序(如Hugo或GitHub)中都受到支持。
要了解更多信息,请查看以下示例,继续我们之前的基本语法。
- 创建表格的语法。
| 编号 | 人员 | 年龄 |
| ----------- | ----------- | ----------- |
| 01 | 克里斯 | 36 |
| 02 | 丹尼斯 | 25 |
| 03 | 大卫 | 24 |
| 04 | 托马斯 | 47 |
解释为:
![在Markdown文件中创建表格](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4MDgiIGhlaWdodD0iMjc5IiB2aWV3Qm94PSIwIDAgODA4IDI3OSI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
- 定义围栏(或多行)代码块的语法。
$ echo "这是第一句话" $ echo "这是第二句话" $ echo "这是第三句话"
解释为:
![在Markdown文件中创建围栏代码块](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4NTUiIGhlaWdodD0iMTYyIiB2aWV3Qm94PSIwIDAgODU1IDE2MiI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
- 创建标题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==)
- 创建定义列表的语法。
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>
- 给文本加上删除线的语法。
~~猫咪从不咬人~~
解释为:
![在Markdown文件中给文本加上删除线](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI3OTAiIGhlaWdodD0iMTI4IiB2aWV3Qm94PSIwIDAgNzkwIDEyOCI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
- 创建任务列表的语法。
📝
任务无法与后端服务器一起工作,但这是一种展示特定工作进度或提供状态更新的好方法。
- [x] 项目蓝图
- [x] 项目设计
- [ ] 预算分配
解释为:
![在Markdown文件中创建任务列表](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE3MSIgdmlld0JveD0iMCAwIDEwMjQgMTcxIj48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)
- 通过复制粘贴或短代码添加表情符号。
📝
您可以通过两种不同的方式向Markdown文件添加表情符号:第一种是直接从表情符号提供站点(如Emojipedia (opens new window))复制粘贴,或者使用表情符号短代码(获取列表 (opens new window))。
## 猫咪对鱼缸说了什么?
你今天看起来鱼-棒极了! :laughing:
解释为:
![在Markdown文件中添加表情符号](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE2MyIgdmlld0JveD0iMCAwIDEwMjQgMTYzIj48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)
- 禁用自动URL链接的语法。
自动URL链接
//www.linuxtldr.com
禁用自动URL链接
`//www.linuxtldr.com`
解释为:
![在Markdown文件中禁用自动URL链接](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxMDI0IiBoZWlnaHQ9IjE0NSIgdmlld0JveD0iMCAwIDEwMjQgMTQ1Ij48cmVjdCB3aWR0aD0iMTAwJSIgaGVpZ2h0PSIxMDAlIiBzdHlsZT0iZmlsbDojY2ZkNGRiO2ZpbGwtb3BhY2l0eTogMC4xOyIvPjwvc3ZnPg==)
- 给文本添加高亮的语法。
在Linux世界中,==Linux TLDR== 将是最好的网站。
解释为:
![在Markdown文件中给文本添加高亮](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4NDEiIGhlaWdodD0iMTAzIiB2aWV3Qm94PSIwIDAgODQxIDEwMyI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
- 指定下标和上标。
C~2~H~3~O~2~NH~4~
X^3^Y^6^
解释为:
![在Markdown文件中添加下标和上标](data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI4MzkiIGhlaWdodD0iMTMyIiB2aWV3Qm94PSIwIDAgODM5IDEzMiI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgc3R5bGU9ImZpbGw6I2NmZDRkYjtmaWxsLW9wYWNpdHk6IDAuMTsiLz48L3N2Zz4=)
这里是Markdown文件中扩展语法列表的结尾。现在,如果您对它们感兴趣并想要练习,应该如何做呢?让我们在下一节中找出答案。