要参加cherry markdown的开源实战了,先来了解一些基础语法吧!
引言
Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML或HTML。然而,随着Markdown的普及,出现了多种不同的实现和语法变体,这导致了在不同平台上的不一致性。为了解决这个问题,CommonMark应运而生,提供了一个统一的规范,确保Markdown文档在任何地方都能保持一致的格式和表现。
什么是CommonMark?
CommonMark是一个规范,不是一个特定的实现。它定义了Markdown的语法,包括基本的块级元素(如段落、标题、列表等)和内联元素(如链接、强调、代码等)。CommonMark的目标是简单、明确、易于实现,同时保持对现有Markdown工具的兼容性。
CommonMark的基本语法
标题
标题使用井号#
来表示,一个井号表示最大的标题(相当于HTML中的<h1>
),两个井号表示次级标题(相当于<h2>
),以此类推,最多六级标题。
# 这是一级标题
## 这是二级标题
### 这是三级标题
段落和换行
段落由一个或多个连续的文本行组成,段落之间用一个或多个空行分隔。换行可以通过在行尾添加两个空格或使用HTML的<br>
标签来实现。
这是第一行文本。这是第二行文本。
这是另一个段落。
列表
列表分为有序列表和无序列表。有序列表使用数字和点来标记,无序列表使用星号*
、加号+
或减号-
。
- 无序列表项一
- 无序列表项二
- 无序列表子项
1. 有序列表项一
2. 有序列表项二
链接和图片
链接和图片使用方括号[]
来定义内容,图片还额外需要一个圆括号()
来定义URL。
[这是一个链接](https://example.com)
![这是图片的替代文本](https://example.com/image.jpg)
强调和代码
强调可以使用星号*
或下划线_
来实现,代码则使用反引号来标记。
*这是斜体*
_这也是斜体_
`这是代码文本`
块引用
块引用使用大于号>
来实现。
> 这是一个引用文本。
代码块
代码块使用三个反引号来定义。
这是代码块
表格
表格使用竖线|
和减号-
来定义列和行。
| 标题1 | 标题2 | 标题3 |
|-------|-------|-------|
| 单元格1 | 单元格2 | 单元格3 |
结语
CommonMark提供了一种标准化的方式来编写Markdown文档,确保了跨平台的一致性。无论你是Markdown的新手还是老手,了解CommonMark规范都能帮助你更有效地使用Markdown。随着越来越多的编辑器和平台支持CommonMark,我们可以期待Markdown的未来发展将更加标准化和统一。
这篇博客提供了CommonMark语法的一个基本概览,希望能够帮助读者更好地理解和使用Markdown。