基础markdown语法 #

Markdown 是一种轻量级的“标记语言”，由 John Gruber 于 2004 年创建，Markdown 的语法十分简单，正是因为其轻量化的特点，才被众多写作爱好者广泛应用

前排提醒: 本文档只是搬运基本的 Markdown 语法并对其简单介绍，并不完整详尽的叙述 Markdown 的各种扩展功能，也不会探讨 Markdown 语法解析等高级内容，预知详情请移步至官方网站

前言 #

首先， Markdown 用于在纯文本文档中添加格式化元素，这意味着它只是将一份纯文本文档，加以一些标记使得其中的一部分内容会被特殊化的处理而已

在使用 Markdown 格式书写时，文本内容存储在带有 .md 或 .markdown 扩展名的纯文本文件中

例如 test.md ，你可以在里面像 .txt 一样书写文字，比如你写了一篇文章，标题title独占一行，在 Markdown 中，你可以将 title 改为 # title ，保存后，将该文本文件交由 arkdown 处理器（也通常称为“解析器”或“实现”）的东西将获取到的 Markdown 格式的文本输出为 HTML 格式，接着你就会发现你的 # title 会被其对应成为一个一级标题

工具推荐 #

书写 Markdown 可以使用 Typora ，同样被推荐的是 vscode 的 markdown all in one 插件

基本语法 #

到了正片，接下来是简单的介绍基本语法的时间

标题语法 #

在某一行的开头使用 # 创建标题，使用n个井号意为 n 级标题，例如

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题

注意到井号串后方需要加一个空格，这是出于兼容性的合理考虑

段落 #

Markdown中的段落是指一段话和一段话之间固定的分隔，要想实现这个，需要在两段话中添加空白行

不要在段落的开头使用空格和tab制表符来缩进

换行 #

在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行，注意和上面所说的段落不相同，这里的换行还是属于同一个段落的

强调 #

强调分为粗体与斜体

上面这句话就是一个最好的例子，使用单星号包裹文字为斜体，双星号为粗体

强调分为**粗体**与*斜体*

而如果需要同时用粗体和斜体突出显示文本，需在单词或短语的前后各添加三个星号或下划线。

以下均为粗斜体
***1***
_**2**_
__*3*__
___4___

要加粗并用斜体显示单词或短语的中间部分，请在要突出显示的部分前后各添加三个星号，中间不要带空格

This is really***very***important text.

引用 #

要创建块引用，请在段落前添加一个 > 符号块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号块引用可以包含其他 Markdown 格式的元素。但并非所有元素都可以使用

列表 #

向下面这样用序号与缩进创建有序列表，用破折号-、星号*或加号+创建无序列表

1.
2.
3.
    1.
    2.
4.

-
-
    -
    -
-

Use `code` in your Markdown file.

代码 #

要将单词或短语表示为代码，请将其包裹在反引号 (`) 中。要创建代码块，请将代码块的每一行缩进至少四个空格或一个制表符。

分割线 #

在某一行写超过三个---创建分割线效果演示如下，为了兼容性，请在分隔线的前后均添加空白行。

图片 #

语法如下

![photo alt](photo url "photo title")

如果你要给图片增加链接，请将图像的Markdown 括在方括号中，然后将链接添加在圆括号中。

[![photo alt](photo url "photo title")](link url)

链接 #

以下是创建一个链接基本的语法，只会显示一个连接的名字，例如本站首页

[本站首页](https://sast-mathematic-sig.github.io)

如果要设置一个鼠标放在上面悬浮的标签的话语法如下，例如本站首页

[本站首页](https://sast-mathematic-sig.github.io "数学SIG首页")

快捷创建一个链接可以用<>包裹一个url或者email

强调链接, 在链接语法前后增加星号。要将链接表示为代码，请在方括号中添加反引号。

参考文献 #

[1]. Markdown 官方教程 https://markdown.com.cn/