Markdown是一种轻量级标记语言,创始人为約翰·格魯伯(英语:John Gruber)。 它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。 这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
一级标题:先输入标题名,再换行,输入3个“=”然后回车。
二级标题:先输入标题名,再换行,输入3 个“-”然后回车。
辅助线是文字格式的一种,常见形式如下划线和中划线,下划线可用于圈出文字中需要注意的部分,删除线可用于表示文字中已经失效的内容。
Markdown 语法里的辅助线包含「中划线(删除线)」一种形式,其他形式的辅助线要通过 HTML 标签进行扩展。中划线使用 「波浪线 ~」来描述。
HTML 标签中 ~~~~ 标签意义为 「删除」,`` 标签意义为 「插入」。删除用一条中划线代表已删除的内容,插入用一条下划线代表新插入的文本。通常删除线和插入线代表文章的修订过程,我们输出的文章要尽量避免使用太多辅助线效果。
在 Markdown 文件中,被「波浪线 “~”」包括的内容会增加中划线效果。
删除线会被渲染成 html 的 del 标签:<del>删除线</del>
斜体斜体粗体粗体
高亮
这是一条删除线
当删除线内部紧跟 "空格" 时,删除线效果会失效。
有效的删除线
~~失效的删除线 ~~
~~ 失效的删除线 ~~
~~ 失效的删除线~~
下划线这是一个下划线
键盘文本
例如,按Ctrl+U键
请参见行内代码。
粗斜体
粗体内嵌斜体
一个Markdown段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行。
分段
这是第一段。
这是第二段。
换行(快捷键:Shift+Enter)
这是第一行,这是第二行。
(1)引用:用于引用单一段落。在文本前面加上大于号“>”,再空格。
这是引用的文本。
(2)块引用:用于引用多个段落。在每一行文本前面加上大于号“>”,再空格。
这是块引用的第一行。这是块引用的第二行。
块引用可以引用多个段落,也可以嵌套引用块。
你可以嵌套引用和块引用,更好地组织和引用信息。示例:
这是一个普通引用。
这是一个嵌套引用。
这是一个更深层次的嵌套引用。
Markdown 的 To-Do List 的内容是由无序列表,复选框,图标几种功能的组合。
在 Markdown 文件中,在 " 无序列表 -,+,* " 后面使用 「中括号 []」 声明复选框。在中括号中写入 x ,便可实现选中效果。
源码:
源码:
源码:
源码:
源码:
Markdown 的 注释 和 HMTL 一样,注释的内容在渲染界面不可见。
怎么在链接后加上title?
网址后面,1个空格 + 双引号里 title 文字。
怎么制作带强调的链接?
用“<>”括住URL就会自动转为链接,不需要加链接标签。
也称页内超链接,也能用于文件与文件之间转跳。
页内转跳:设置锚点后,可以进行页内转跳,Ctrl+单击锚点,可以转跳到任意标题。
基本语法为:
*锚点里的标题名必须与实际标题一致。
文件转跳:设置锚点后,Ctrl+单击锚点,立刻跳转到另一个md文件的开始位置。
基本语法为:
示例:
*转跳路径为本地路径,从同级文件夹开始即可。
Markdown 使普通文本具有格式,但它的原生语法并不支持修改字体、字号。为了实现丰富文字样式的需求,我们需要通过增加 HTML 标签实现此类效果。
在 Markdown 文件中,建议使用 font 标签的 face 属性修改文字字体。
字体在不同环境中支持程度不同,表现结果可能也不同。在设计上,尽量选择较为通用的字体。以下是一些 Web 常用中文字体:
Markdown 文档中的字号定义有三种主要方式,第一种是使用 <font> 标签;第二种通过 <big> 或者 <small> 标签;第三种是通过修改 style 样式实现。
使用 style 样式修改全局字体和字号。
方法一:
方法二:
颜色可以使普通文字表达出更深刻的含义,比如红色用于醒目与警示、绿色用于表达良好与正常等。
Markdown 使普通文本具有格式,但它的原生语法并不支持修改前景色和背景色。为了实现丰富文本颜色的需求,我们需要通过增加 HTML 标签实现此类效果。
在 Markdown 文件中,建议使用 <font> 标签的 color 属性修改文字颜色。
举例1:
红色绿色蓝色
使用 rgb 颜色值
使用十六进制颜色值
除了修改 color 属性外,还可以使用 style 样式属性修改文字颜色。
举例2:
红色绿色蓝色
使用 rgb 颜色值
使用十六进制颜色值
Markdown 文档中定义文字背景色需要通过修改 style 样式实现。
红色绿色蓝色
使用 rgb 颜色值
使用十六进制颜色值
利用 style 的丰富样式,我们可以定义出丰富的文字形式。
使用图片作背景
太阳太阳,给我们带来,七色光彩
渐变背景色
在typora里插入的方法:1、例如<img src=''>,在src里输入这段编码;2、通过常见的![][src],src里是编码,可以看到这里是中括号[],而不是括号。
使用Typora工具,右击,选择缩放,选择缩放的比例即可。
Markdown 中提供了对以下特殊字符的转义支持。
在任何一款现代程序语言中,注释都是至关重要的,它是源代码文件提升可读性的重要补充,也是多人协作时的重要工具。
Markdown 的注释可以通过三种方法实现:
表格通常作为一种布局形式,用于结构化的数据展示。
Markdown 表格包含三个部分:表头、分割线、数据。
Markdown 表格由 「竖线 |」、「减号 -」、「冒号 :」三种符号组成。
源码:
举例1:
源码:
举例2:
源码:
流程图支持的方向
在 Mermaid 中可以使用一些基本符号定义节点的形状,例如:圆角形、跑道形、气缸形、非对称形状、菱形、六角形、平行四边形、梯形。
圆角形节点的语法
圆形节点的语法
非对称形节点的语法
菱形节点的语法
六角形节点的语法
平行四边形节点的语法
梯形节点的语法
无向线段连接线
点状连接线
粗实线连接线
时序图连接类型
activate 对象X和deactivate 对象X结合使用
画法如下,注意体会箭头符号后的 + 和 - 的(相结合)使用方法和效果,它们相当于激活框的开关。
举例1:
在条件满足时,重复发出消息序列。相当于编程语言中的 while 语句。
举例1:
举例2:
在多个条件中作出判断,每个条件将对应不同的消息序列。相当于 if 及 else if 语句。
在某条件满足时执行消息序列,否则不执行。相当于单个分支的 if 语句。
在某条件满足时执行消息序列,否则不执行。相当于单个分支的 if 语句。
学生使用教务系统时序图展示。
类是类图中的核心组成,类的成员包括属性和方法,以及一些扩展信息。在类图中,一个类实例由三层组成:
类的定义有两种方式,第一种是形如 class Animal 这样的直接描述,另一种是通过关系来定义类,如 Vehicle <|-- Car。
举例1:
举例2:
类成员包含属性、方法;区分属性和方法的语法依赖于是否以「小括号 ()」结尾,没有括号的成员会被解释为属性,有括号的成员会被解释为方法。
成员的作用域作为可选项,定义是在成员的开头,有以下四种:
除此之外,通过在 () 后面增加 「星号 *」和「美元符号 $」,可以用来描述方法成员的抽象或静态属性。
类成员有两种定义方法。
类图中「类」之间的逻辑关系由连接线表示,定义的形式如:[类A][箭头][类B]: 标签文字。
不同的逻辑关系定义如下:
我们可以通过标签文本描述类的元数据,例如:抽象类、接口、服务、枚举等。
元数据的通过「双尖括号」定义,有两种写法。
一个关于动物的类图。
状态图 (Statechart) 是描述一个实体基于事件反应的动态行为,是使对象达到某种状态的事件、条件或操作的图形化描述。
一个完整的状态图由状态、转换组成。
「转换」在状态图中表现为连接两个状态节点的单向箭头,在 Mermaid 扩展语法中的写法为「字符箭头 -->」。
通过 (行内容): label 的形式,为转换添加描述文本。
在负责的状态描述中,有的状态节点会包含一系列的子状态,我们可以用组合「嵌套」的方式来描绘它们。在 Mermaid 扩展中,描述嵌套的方式,是使用「花括号 {}」描述子状态。
「嵌套」的层数没有限制。
对于非单一结果的状态转换,我们可以使用 <<fork>> 和 <<join>> 标签实现。
有时候图表元素不能完全表达我们的设计思路,这时候需要在图中加入文字描述。在 Mermaid 语法中,使用 note <right|left> of <state ID> 备注内容 end notes 的方式,将备注添加到状态节点的右侧(左侧)。
基本的甘特图由「标题」、「日期格式约定」、「分组及任务」三部分组成。
通过设置 dateFormat 属性,可以指定甘特图定义日期时的解析方式。
日期的格式支持以下情形:
甘特图上的对象都是以时间为基础而存在的,对于时间,我们可能有非常多的定义需求,比如精度上的「年」、「月」、「日」、「时」等,又比如「24H」或者 「12H」这样写法上的不同等。Mermaid 为时间提供了丰富的语法支持。
完整的定义语法如下:
Mermaid 甘特图中,每个任务隶属于一个分组,一个分组内可以定义多个任务,一张甘特图表中可以包含多个分组。
甘特图中的任务定义格式形如:
其中「任务名」和「周期」两项是必要项。
任务状态:
任务时长:
饼图(Pie chart)是将一个圆形,分成面积相同或不同的若干区域,用来表示不同内容占比的图形。
饼图的定义包含「标题」、「内容名称」和「内容权重」三项,其中「内容权重」会在渲染时,自动转换为百分比并显示在饼图上。
上标、下标是一种文字的特殊写法,常用于化学式、数学公式、引用文字的脚注等。
在 Markdown 中,我们可以通过 和 标签来实现上标和下标。
源码:a<sup>2</sup> + b<sup>2</sup> = c<sup>2</sup>
效果:a2 + b2 = c2
在专业的学术论文中,数学公式往往是不可或缺的。在 Word 中,想表达出一个复杂的公式非常繁琐,幸运的是 Markdown 其语法中,支持使用 LaTeX 语法实现在文档中插入数学公式。
Markdown 中的数学公式也分为「行中公式」和「独立公式」两种。
行中公式使用两个单独的「美元符 $」表示。
$ 1 + 1 = 2 $
独立公式的写法是将公式两边用两个连续的「美元符 $$」包裹,换行通过在行尾添加 \\ 实现。
$$x + y = 10 \x - y = 6 \2x = 16 \x = 8 \y = 2$$
四则运算符是理工运算中的基础,主要包含加减乘除和绝对值运算。
加法符号:$x+y=z$减法符号:$x-y=z$加减符号:$x \pm y=z$减加符号:$x \mp y=z$叉乘符号:$x \times y=z$点乘符号:$x \cdot y=z$星乘符号:$x \ast y=z$除法符号:$x \div y=z$斜除符号:$x/y=z$分式1:$\frac{x+y}{y+z}$分式2:${x+y} \over {y+z}$绝对值:$|x+y|$
等于符号:$x+y=z$大于符号:$x+y>z$小于符号:$x+y<z$大于等于符号:$x+y \geq z$小于等于符号:$x+y \leq z$不等于符号:$x+y \neq z$不大于等于符号:$x+y \ngeq z$不大于等于符号:$x+y \not\geq z$不小于等于符号:$x+y \nleq z$不小于等于符号:$x+y \not\leq z$约等于符号:$x+y \approx z$恒定等于符号:$x+y \equiv z$
平均数符号:$\overline{xyz}$开二次方符号:$\sqrt x$开方符号:$\sqrt[3]{x+y}$对数符号:$\log(x)$极限符号:$\lim^{x \to \infty}{y \to 0}{\frac{x}{y}}$极限符号:$\displaystyle \lim^{x \to \infty}{y}}$求和符号:$\sum^{x \to \infty}{y \to 0}{\frac{x}{y}}$求和符号:$\displaystyle \sum^{x \to \infty}{y}}$积分符号:$\int^{\infty}{0}{xdx}$积分符号:$\displaystyle \int^{\infty}$微分符号:\partial,如:$\frac{\partial x}{\partial y}$矩阵符号:$\left[ \begin{matrix} &1 &2 &\cdots &4 &5 &6 &\cdots &8\ &\vdots &\ddots &\cdots &13 &14 &15 &\cdots &16\end{matrix} \right]$
阿尔法:$\Alpha$,$\alpha$贝塔:$\Beta$,$\beta$伽玛:$\Gamma$,$\gamma$德尔塔:$\Delta$,$\delta$艾普西龙:$\Epsilon$,$\epsilon$捷塔:$\Zeta$,$\zeta$依塔:$\Eta$,$\eta$西塔:$\Theta$,$\theta$艾欧塔:$\Iota$,$\iota$喀帕:$\Kappa$,$\kappa$拉姆达:$\Lambda$,$\lambda$缪:$\Mu$,$\mu$拗:$\Nu$,$\nu$克西:$\Xi$,$\xi$欧麦克轮:$\Omicron$,$\omicron$派:$\Pi$,$\pi$柔:$\Rho$,$\rho$西格玛:$\Sigma$,$\sigma$套:$\Tau$,$\tau$宇普西龙:$\Upsilon$,$\upsilon$发艾:$\Phi$,$\phi$器:$\Chi$,$\chi$普赛:$\Psi$,$\psi$欧米伽:$\Omega$,$\omega$
$$a_n = a_1q^{n-1}= \frac {a_1}{q} \cdot q^n(n \in N^*) \其中前 n 项的和公式为:\S_n = \left{\begin{aligned}\frac {a_1 \cdot (1-q^n)}{1-q} &,q \neq 1 \