- 文集信息
- 目录大纲
- 最新文档
- 知识宇宙
文集详情
文集导读
1. Markdown 基础语法
Markdown 基础语法详解及实践
引言
Markdown 是一种轻量级的标记语言，旨在简化文本格式化操作。它由约翰·格鲁伯（John Gruber）于2004年创建，其设计理念是让文档既易于阅读又便于编写。Markdown 的核心思想是通过简单的符号和结构来表示复杂的格式，如加粗、斜体、列表等。
本文将详细介绍 Markdown 的基础语法，并提供丰富的代码示例和实践指导。我们将从基本元素开始，逐步深入到更复杂的结构化内容格式。
标题
在 Markdown 中，标题是最常见的结构化元素之一。它们用于组织文档并显示不同级别的标题。Markdown 提供了六种标题级别，使用 # 符号表示，数量越多，标题级别越低。
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
当上述代码被解析时，会生成相应级别的标题。例如：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
为了提高可读性，建议每段标题后留一个空行。
段落与换行
段落是 Markdown 文档的基本构建块。一段文字会被自动视为一个段落，除非用特殊符号或空行将其分隔开。
这是一个段落。 这是另一个段落。
输出效果如下：
这是一个段落。
这是另一个段落。
如果需要在同一段内进行换行而不形成新段落，可以在行尾添加两个以上的空格，然后按回车键。
这是一个段落， 这样可以实现换行。
输出效果如下：
这是一个段落，
这样可以实现换行。
加粗与斜体
Markdown 支持通过简单符号快速改变字体样式。加粗可以通过双星号 ** 或双下划线 __ 实现；斜体则通过单星号 * 或单下划线 _ 实现。
加粗文字：**加粗** 或 __加粗__ 斜体文字：*斜体* 或 _斜体_
输出效果如下：
加粗文字：加粗 或 加粗
斜体文字：斜体 或 斜体
需要注意的是，在某些环境中，比如 GitHub，反斜杠 \ 可以用来转义这些符号，防止它们被解释为格式控制符。
列表
Markdown 支持有序列表和无序列表两种类型。
无序列表
无序列表使用星号 *、加号 + 或减号 - 作为列表项的开头符号。
- 第一项 - 第二项 - 子项1 - 子项2
输出效果如下：
-
第一项
-
第二项
-
子项1
-
子项2
-
有序列表
有序列表通过数字加点的形式定义，数字的具体值通常不重要，因为最终渲染时会自动生成连续编号。
1. 第一步 2. 第二步 3. 第三步
输出效果如下：
-
第一步
-
第二步
-
第三步
对于嵌套列表，只需适当缩进即可：
1. 第一步 1. 子步骤1 2. 子步骤2 2. 第二步
输出效果如下：
-
第一步
-
子步骤1
-
子步骤2
-
-
第二步
链接
链接是连接外部资源的重要手段。Markdown 提供了两种形式的链接：行内式和引用式。
行内式链接
行内式链接直接在文本中指定 URL。
这是一个[链接](https://www.example.com)。
输出效果如下：
这是一个链接。
引用式链接
引用式链接先定义链接地址，然后在正文中引用。
这是一个[链接][id]。 [id]: https://www.example.com
输出效果如下：
这是一个链接。
图片
图片的插入方式类似于链接，只是在方括号前加上感叹号 !。
输出效果如下：
也可以采用引用式图片：
![替代文本][id] [id]: https://www.example.com/image.jpg
引用块
引用块使用大于号 > 来标记。
> 这是一段引用文字。 > 它可以包含多行内容。
输出效果如下：
这是一段引用文字。
它可以包含多行内容。
代码块
代码块用于展示代码片段。有两种主要形式：行内代码和多行代码块。
行内代码
行内代码使用反引号 ` 包围。
使用 `console.log()` 打印消息。
输出效果如下：
使用 console.log() 打印消息。
多行代码块
多行代码块使用三个反引号 ``` 包围，并可选地指定语言以启用语法高亮。
function greet(name) { console.log(`Hello, ${name}!`); } greet('World');
输出效果如下：
function greet(name) { console.log(`Hello, ${name}!`); } greet('World');
水平线
水平线通过三个或更多个星号 ***、下划线 ___ 或减号 --- 创建。
--- *** ___
输出效果如下：
表格
Markdown 支持表格功能，但并非所有实现都完全支持。表格使用管道符 | 分隔列，并用 - 定义表头和数据行之间的分隔线。
| 列1 | 列2 | 列3 | | --- | --- | --- | | 数据1 | 数据2 | 数据3 | | 数据4 | 数据5 | 数据6 |
目录大纲
最新文档
知识宇宙
正在加载知识图谱...