📜  docs (1)

📅  最后修改于: 2023-12-03 15:14:46.875000             🧑  作者: Mango

Markdown 文档

什么是 Markdown?

Markdown 是一种轻量级标记语言,它以易读易写的纯文本格式编写文档,然后转换为 HTML 格式进行发布。它的设计目标是让人们更容易地书写结构化的文稿,比如文章、论坛帖子、电子邮件等等。

Markdown 的语法十分简洁明了,几乎可以达到所见即所得的效果。它兼容 HTML 标签,也支持图片、链接、列表等功能,非常适合用来写技术文档、博客等等。

Markdown 的语法
标题

Markdown 支持 6 级标题,用 # 符号表示,# 的数量对应标题的级别,例如:

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
文本

Markdown 的文本语法比较简单,主要包括粗体、斜体、删除线、代码等。

使用 ** 代表粗体,使用 * 或 _ 代表斜体,使用 ~~ 代表删除线,使用反引号(`)代表代码,例如:

**这是粗体**
*这是斜体*
~~这是删除线~~
`这是代码`
列表

Markdown 支持有序列表和无序列表,用 * 或 + 或 - 表示无序列表,用数字加点表示有序列表,例如:

- 无序列表项 1
- 无序列表项 2
- 无序列表项 3

1. 有序列表项 1
2. 有序列表项 2
3. 有序列表项 3
链接和图片

Markdown 支持链接和图片,链接使用方括号([])表示链接文字,紧随其后的圆括号(())内填入链接 URL;图片使用感叹号(!)加方括号表示图片的替代文字,紧随其后的圆括号(())内填入图片 URL。例如:

这是一个 [链接](http://example.com)。

这是一张图片:![图片](http://example.com/image.png)
引用

Markdown 支持引用,用 > 符号表示,例如:

> 这是一个引用段落。
代码块

Markdown 支持代码块,用反引号(`)表示行内代码,用三个反引号(```)表示块级代码,例如:

这是一段行内代码:`echo "Hello, world!"`

这是一个代码块:

int main() { printf("Hello, world!\n"); return 0; }


### 分割线

Markdown 支持分割线,用三个或更多的星号、减号或底线表示,例如:





## Markdown 的转换工具

Markdown 仅仅是一种标记语言,需要使用特定的工具将其转换为 HTML、PDF、docx 等标准文档格式。常见的 Markdown 转换工具有:

- **Pandoc**:一个功能强大的文档转换工具,支持将 Markdown 转换为多种文档格式。
- **Markdown Preview Enhanced**:一个 Markdown 预览工具,支持实时预览 Markdown 的效果。
- **Typora**:一款 Markdown 编辑器,支持 WYSIWYG 编辑模式和实时预览模式,让你轻松愉快地写 Markdown。
- **GitBook**:一款基于 Git 的在线图书编辑和发布工具,支持使用 Markdown 来写作。

以上只是其中的一部分工具,建议根据自己的需求来选择合适的工具。

## 总结

Markdown 是一种简单易用、且功能强大的标记语言,在程序员中应用广泛。它的语法简单,学习成本极低,可以轻松写作文章、技术文档、博客等等。同时,转换工具的支持也让 Markdown 的使用更加便捷,让你可以更自由地掌控你的文档。