一、什么是 Markdown
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后将其转换成有效的 XHTML(或者 HTML)文档。这种语言的设计目标是使人们能够使用易读易写的纯文本格式编写文档,同时能够轻松地将其转换为结构良好的 HTML 文档。
二、基本语法
(一)标题
一级标题
使用#号来表示一级标题,例如# 这是一级标题。
二级标题
使用##号来表示二级标题,例如## 这是二级标题。
以此类推,###表示三级标题,####表示四级标题,最多可以到六级标题。
(二)段落和换行
段落
段落之间使用空行来分隔。例如:
收起
plaintext
这是第一段。这是第二段。
换行
在一行的末尾添加两个空格,然后按回车键可以实现换行。例如:
收起
plaintext
第一行文本。
第二行文本。
(三)文本样式
加粗
使用**或__将文本包围起来可以实现加粗。例如:**这是加粗的文本**或__这是加粗的文本__。
斜体
使用*或_将文本包围起来可以实现斜体。例如:*这是斜体的文本*或_这是斜体的文本_。
加粗斜体
使用***或___将文本包围起来可以实现加粗斜体。例如:***这是加粗斜体的文本***或___这是加粗斜体的文本___。
(四)列表
无序列表
使用-、+或*来表示无序列表项。例如:
收起
plaintext
复制
- 第一项
- 第二项
+ 第三项
* 第四项
有序列表
使用数字加.来表示有序列表项。例如:
收起
plaintext
复制
1. 第一点
2. 第二点
3. 第三点
(五)链接
行内链接
格式为[链接文字](链接地址)。例如:[百度](https://www.baidu.com)。
引用链接
先在文档的某个地方定义链接地址,例如[百度]: https://www.baidu.com,然后在需要使用链接的地方使用[链接文字][百度]。
(六)图片
插入图片
格式为![图片说明](图片地址)。例如:![这是一张图片](https://example.com/image.jpg)。
(七)引用
引用文本
使用>来表示引用。例如:
收起
plaintext
复制
> 这是一段引用的文本。
(八)代码
行内代码
使用反引号将代码包围起来。例如:这是一段代码示例。
代码块
使用三个反引号 ``` 或者缩进 4 个空格来表示代码块。例如:
收起
python
复制
def hello():
print("Hello, World!")
三、高级用法
(一)表格
创建表格
使用|来分隔列,使用-来分隔表头和表格内容。例如:
收起
plaintext
复制
| 列1 | 列2 |
| --- | --- |
| 内容1 | 内容2 |
(二)任务列表
创建任务列表
使用- [ ]表示未完成的任务,- [x]表示已完成的任务。例如:
收起
plaintext
复制
- [ ] 任务1
- [x] 任务2
四、Markdown 工具
在线编辑器
有许多在线的 Markdown 编辑器,如 StackEdit、Dillinger 等,这些编辑器提供实时预览功能,方便用户编写和查看效果。
本地编辑器
本地编辑器如 Typora(支持实时预览)、Visual Studio Code(通过插件支持 Markdown)等,用户可以根据自己的喜好选择。
五、总结
Markdown 以其简洁的语法和广泛的适用性,成为了很多人编写文档、博客、笔记等的首选。通过掌握基本的和高级的语法,再结合合适的编辑工具,能够高效地创作出结构清晰、格式美观的文档。