MarkDown语法介绍

MarkDown是什么?

Markdown 是一种轻量级标记语言,设计用来简化文本格式化的过程。它的目标是让用户能够以纯文本的方式编写文档,同时能够轻松地将文本转换为格式化的内容,如HTML。Markdown 由约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)共同创建,于2004年首次发布。

Markdown的主要特点包括:

专注于文字内容:Markdown的设计理念是让作者专注于创作内容,而不必过多关注排版和格式。这使得它成为作者和写手的首选工具,因为它让创作变得更为流畅和高效。 纯文本,易读易写:Markdown文件是纯文本文件,可以在任何文本编辑器中打开和编辑。这意味着你可以轻松地在不同平台和设备上编辑Markdown文档,而不必担心格式兼容性问题。 语法简单:Markdown的语法非常简单,没有学习曲线,几乎任何人都可以快速上手。你可以使用一些简单的符号和标记来实现文本的格式化,如标题、列表、链接和图片等。 使用Markdown与使用传统的文字处理软件(如Microsoft Word)有很大的不同。在Word中,你通常需要使用按钮和菜单来进行格式化,而Markdown则通过一种轻量级的标记语法来实现相同的效果。例如,要创建标题,只需在文本前面加上一个井号(# Heading One),要加粗文本,只需使用两个星号将文本包裹起来(this text is bold)。

MarkDown语法

Markdown 能被使用来撰写电子书,如:Gitbook。

当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

标题语法

要创建标题,请在单词或短语前面添加井号 (#) 。# 的数量代表了标题的级别。例如,添加三个 # 表示创建一个三级标题 (<h3>) (例如:### My Header)。

字体

  • 加粗 要加粗的文字左右分别用两个*号包起来
  • 斜体 要倾斜的文字左右分别用一个*号包起来
  • 斜体加粗 要倾斜和加粗的文字左右分别用三个*号包起来
  • 删除线 要加删除线的文字左右分别用两个~~号包起来

示例: 这是加粗的文字 这是斜体的文字 这是斜体加粗的文字 这是加删除线的文字

引用

在段落的每行或者只在第一行使用符号>,还可使用多个嵌套引用,

示例:

这是引用的内容

这是引用的内容

这是引用的内容

分割线

三个或者三个以上的 - 或者 * 或者_都可以。

示例:







图片

  1. 插入互联网上图片

语法:

![图片描述](图片链接 ‘‘图片title’’)

图片描述就是显示在图片下面的文字,相当于对图片内容的解释。 图片title是图片的标题,当鼠标移到图片上时显示的内容。 注意:title可加可不加 注意:这个图片描述可以不写。

  1. 插入本地图片

语法:

![图片描述](图片本地路径 ‘‘图片title’’) 图片描述就是显示在图片下面的文字,相当于对图片内容的解释。 图片title是图片的标题,当鼠标移到图片上时显示的内容。 注意:title可加可不加 注意:这个图片描述可以不写。

本地图片测试

超链接

语法:

超链接名 注:title可加可不加 示例:

知乎 百度

列表

语法: 无序列表用 - + * 任何一种都可以

  • 无序列表内容
  • 无序列表内容
  • 无序列表内容

注意:- + * 跟内容之间都要有一个空格

有序列表语法: 数字加点

列表嵌套

上一级和下一级之间敲一个Tab键即可

  1. 列表 1
    1. 列表1.1 1
    2. 列表1.2 2
  2. 列表2 任务列表:

表格

表头 表头 表头
内容 内容 内容
内容 内容 内容

第二行分割表头和内容。

  • 有一个就行,为了对齐,多加了几个 文字默认居左 -两边加:表示文字居中 -右边加:表示文字居右
姓名 性别 分数
小明 100
小红 89
小飞 88

完成事项

  • 已经完成的事 1
  • 已经完成的事 2
  • 已经完成的事 3
  • 仍未完成的事 4
  • 仍未完成的事 5

代码

语法: 单行代码:代码之间分别用一个反引号包起来

代码内容 代码块: 1.代码之间分别用三个反引号包起来,且两边的反引号单独占一行

代码块语法:

1
2
print("Hello, World!")
import numpy as np
1
2
print("Hello,World!")
import numpy as np

公式

行内公式:

单位圆 $x^2+y^2=1$

公式块:

$$ \begin{cases} x=\rho\cos\theta \\ y=\rho\sin\theta \\ \end{cases} $$

流程图

MarkDown中的流程图语法叫flow,该语法只有两个注意事项:

定义元素 连接定义好的元素 示例:

()flow st=>start: 开始 op=>operation: My Operation cond=>condition: Yes or No? e=>end st->op->cond cond(yes)->e cond(no)->op ()

st=>start: 开始 op=>operation: My Operation cond=>condition: Yes or No? e=>end st->op->cond cond(yes)->e cond(no)->op

换行

方法1: 连续两个以上空格+回车

方法2:使用html语言换行标签 <br>

缩进

推荐使用第三种缩进方式

  缩进1/4中文   缩进半个中文,一个字符   缩进一个中文,2个字符

示例:

 你若安好,便是晴天。  你若安好,便是晴天。  你若安好,便是晴天。

Licensed under CC BY-NC-SA 4.0
使用 Hugo 构建
主题 StackJimmy 设计