Markdown语法全面指南-Prince Azubuike-Medium
Markdown指南
简介 #
很可能你在不知不觉中写过Markdown文本,无论是在像Stackoverflow这样的在线论坛上,还是在像Github或Bitbucket这样的协作平台上。
Markdown是一种简单易用的标记语言,由John Gruber于2004年创建。如今,它是世界上最广泛使用的标记语言。
Markdown文件使用.md或.markdown文件扩展名,并且可以使用处理软件(如Typora (opens new window))将其转换为HTML。
在本文中,我们将探讨Markdown的语法以及如何使用它来格式化文本。
Markdown的用途是什么? #
Markdown是一种纯文本格式,用于创建可以轻松转换为HTML的文档。 下面是一些使用Markdown文件的地方:
- GitHub README: Markdown在GitHub存储库的README文件中广泛用于编写文档、API示例、安装指南和贡献指南。
- Markdown也被用于论坛和博客文章。
- 静态网站生成器也支持Markdown文件。
Markdown可以用来格式化纯文本的标记语言。它允许创建丰富的文本格式,如粗体和斜体。以下是你可以使用Markdown格式化的示例。
- 标题。
- 链接。
- 图像。
- 引用块。
- 代码块。
- 列表。
- 强调。
- 水平分隔线。
Markdown语法 #
Markdown提供了不同的语法来丰富文本格式;以下是这些语法和如何使用它们。
- 标题: 井号(#)用于创建Markdown标题。一个井号是一级标题,两个井号是二级标题,以此类推,直到六级标题。 # 一级标题
二级标题 #
三级标题 ... ###### 六级标题 #
- 加粗: 使文本更加强调和加重。用两个星号 ** 包围文本使其加粗。
**加粗**
- 斜体: 用单个下划线 ( _ ) 包围文本使其倾斜。
_斜体_
- 删除线: 删除线是一种格式选项,用于划掉不再有效或相关的文本。用两个波浪线 (~~) 包围文本以创建删除线。
~~删除线~~
- 引用块: 通过在文本开头添加大于号 ( > ) 来创建引用块。
> 引用块
- 代码块: 在Markdown中,你可以使用 `代码块` 选项将一大段代码插入到文本文档中。根据Markdown环境的不同,代码块的背景颜色和边框也会有所不同,以便与其他文本区分开来。 以下是Markdown的中文翻译,同时删除了一级标题:
Lists(列表):在Markdown中可以创建两种列表,就像在HTML中的常规列表一样。可以使用星号(*)创建无序列表或点状列表,而有序列表可以使用从一(1. )开始的数字和前导句点来创建。
1. 数字列表
2. 数字列表2
1. 嵌套列表1
2. 嵌套列表2
* 点状列表1
* 点状列表2
* 嵌套点状列表1
* 嵌套点状列表2
Links(链接):在Markdown文档中创建锚链接的语法是[这里是文本](这里是链接)。例如:
[Markdown主页](https://www.markdownguide.org/)
Tables(表格):在Markdown文档中,使用两个字符来创建表格: 使用 Markdown 语法,可以创建丰富的文本格式,如粗体和斜体、标题、链接、图片、引用、代码块、列表、强调和水平线。
表格: 在 Markdown 文档中,使用管道字符 (|) 来创建表格列,破折号字符 (—) 来创建表格行。
| 姓名 | 电子邮件 |
| ---------|-----------------|
| John Doe | [email protected] |
| Jane Doe | [email protected] |
图片: Markdown 文档中的图片与链接类似,但是图片在方括号 [ ] 前面使用感叹号字符 (!)。
![markdown logo](https://markdown-here.com/img/icon256.png)
结论 #
Markdown 是一种广泛使用的标记语言,由 John Gruber 在 2004 年创建。它是一种纯文本格式,用于创建可以轻松转换为其他格式(包括 Microsoft Word)的文档。Markdown 文件在 GitHub 的 README 文件、论坛、博客文章和静态站点生成器中使用。Markdown 语法允许创建粗体和斜体、标题、链接、图片、引用、代码块、列表、强调和水平线等丰富的文本格式。
就这样!如果您有任何问题,请随时问。 如果对此有任何想法,请务必留下评论。
如果你觉得这篇文章有帮助,请给我鼓励。