Markdown语法全面指南-Prince Azubuike-Medium

Markdown语法全面指南-Prince Azubuike-Medium

Prince Azubuike (opens new window)

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格式化的示例。

  1. 标题。
  2. 链接。
  3. 图像。
  4. 引用块。
  5. 代码块。
  6. 列表。
  7. 强调。
  8. 水平分隔线。

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 语法允许创建粗体和斜体、标题、链接、图片、引用、代码块、列表、强调和水平线等丰富的文本格式。

就这样!如果您有任何问题,请随时问。 如果对此有任何想法,请务必留下评论。

如果你觉得这篇文章有帮助,请给我鼓励。

你可以在这里关注我的Twitter账号。 (opens new window)