Markdown 教程

前言

什么是 Markdown?

Markdown 是一种轻量级的标记语言,与超文本标记语言‌(HyperText Markup Language,简称 HTML)不同,Markdown 的目标是让人们能够使用易读易写的纯文本格式编写文档,然后可以轻松地转换成 HTML 文档或其他格式的文档,如:PDF 等。

Markdown 文件名后缀为 .md.markdown.

为什么学 Markdown?

学习 Markdown 是一个提升编写效率、简化写作难度和提升文档质量的绝佳选择,大部分开源软件及运维的文档都是使用 Markdown 格式编写的。应用范围十分广泛。

Markdown 的语法非常简单,只包含少量易于记忆的符号。以下是标准 Markdown 的全部的语法标记符号。

标准 Markdown 语法标记

\   反斜杠
`   反引号
*   星号
_   下划线
{}  大括号(又名花括号)
[]  中括号(又名方括号)
()  小括号
#   井号
+   加号
-   减号
.   点号
!   叹号

在内容中用到上述符号,需要前面加上一个反斜杠 \ 进行转义,如:\* 表示一个星号 *

Markdown 按换行方式分为两类:

  1. 块元素:每一个新元素总是重新开始一个新行,并独自占用一行,前后不可有其他内容。类型如下:

    • 标题(Headers)
    • 段落和换行符(Paragraphs and Line Breaks)
    • 引用块(Blockquotes)
    • 列表(Lists)
    • 代码块(Code Blocks)
    • 水平线(Horizontal Rules)
  2. 行内元素:不会从新行开始,只占据必要的宽度。类型如下:

    • 超链接(Links)
    • 强调(Emphasis)
    • 代码(Code)
    • 图片(Images)

Markdown 按语法规范分为两类:

  1. 标准 Markdown。
    • 所有的 Markdown 软件都支持且兼容。如: 列表、代码块。
  2. 扩展 Markdown。
    • 扩展语法,部分软件支持。如:表格、目录、LeTaX 公式等。

常用的Markdown编辑软件: