3.7 代码
如果要将单词或短语表示为代码,请将其包裹在反引号 (`
“) 中即可。
Markdown | HTML | 效果 |
---|---|---|
\Hello\ World. |
<code\> Hello</code> Word. |
Hello World. |
转义反引号
如果表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(“)中
注意:当反引号在代码区段的起始和结束端时,需要在代码区段的起始和结束端都添加一个空格,再用双反引号(“)包裹。
代码块
创建代码块,要将代码块的每一行缩进至少四个空格或一个制表符。一个代码区块会一直持续到没有缩进的那一行(或是文件结尾)。在代码区块里面, &
、 <
和>
会自动转成 对应HTML 实体&
、<
和>
代码如下:
<html>
<head>
</head>
</html>
效果如下:
<html>
<head>
</head>
</html>
围栏式代码块(fenced code blocks)
围栏式代码块,不需要缩进任何行。
使用围栏式代码块很简单:在代码块之前和之后的行上使用三个反引号
`,并指定一种编程语言(也可以不指定)。
同时许多Markdown处理器都支持围栏代码块的语法高亮功能。此功能允许为编写代码所用的编程语言添加带颜色的语法高亮显示。如需添加语法高亮,需在围栏代码块前的反引号旁指定所用的编程语言。
代码如下:
```Java
public class Hello{
public static void main(String[] args) {
System.out.print("Hello,World!");
}
}
效果如下:
```Java
public class Hello{
public static void main(String[] args) {
System.out.print("Hello,World!");
}
}
3.8 公式
Markdown支持使用 MathJax 来渲染 LaTex 数学表达式。
要书写数学表达式,将表达式包裹在doller符 ($
) 中即可。
\$\$…$$ 或者 \[…\] 或者 “`math 中的数学表达式将会在块内显示。
$E=mc^2$
效果如下:
数学公式块
创建数学公式块块很简单:在代码块之前和之后的行上添加两个doller符$$
即可。
如果要在公式块内换行,在换行的位置使用\\。
$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
$$
效果如下:
下标
Markdown 处理器允许使用下标将一个或多个字符定位在略低于正常行的位置。要创建下标,请在字符前后使用一个波浪号~
。
Markdown | HTML | 效果 |
---|---|---|
H\~2~O | H\2\O | H~2~O |
上标
Markdown 处理器允许使用上标将一个或多个字符放置在稍高于正常行的位置。要创建上标,请在字符前后使用一个插入符号 ^
。
Markdown | HTML | 效果 |
---|---|---|
X\^2^ | X\2\ | X^2^ |
高亮
Markdown 处理器允许使用高亮来突显文本。效果看起来像==这样==。要使用高亮,请在单词前后使用两个等号==
。
Markdown | HTML | 效果 |
---|---|---|
\==highlight== | \highlight\ | ==highlight== |
3.9 表格
创建表格,需要用三个或更多个减号(---
)来为每个列创建表头,并使用管道符(|
)来分隔每个列。为兼容考虑,还需要在行的两侧添加管道符。
| Syntax | Description |
| ----------- | ----------- |
| Header | Title |
| Paragraph | Text |
效果如下:
Syntax | Description |
---|---|
Header | Title |
Paragraph | Text |
单元格宽度是可变的,如下所示。效果一样。
| Syntax | Description |
| --- | ----------- |
| Header | Title |
| Paragraph | Text |
对齐
通过在标题行中的减号的左侧或右侧或两侧添加冒号(:),可以将对应列中的文本向左(:---
)或向右(---:
)或居中(:---:
)对齐。
| Syntax | Description | Test Text |
| :--- | :----: | ---: |
| Header | Title | Here's this |
| Paragraph | Text | And more |
效果如下:
Syntax | Description | Test Text |
---|---|---|
Header | Title | Here’s this |
Paragraph | Text | And more |
表格内联其他Markdown语法
可以在表格中使用Markdown语法设置文本格式。例如:可以添加链接,代码区段(仅反引号(`
“)中的单词或短语,而不是代码块)和强调。
但是无法添加标题,块引用,列表,分隔线,图像或HTML标签。
在表中转义管道符
可以通过表格的HTML字符代码(|
)在表中显示管道符(|
)。
3.10 分隔线
在单独一行上使用三个或多个星号 (
) 可以创建分隔线,但是注意,行内不能包含其他内容。星号或减号中间可以插入空格。 ***
)、减号 (
---
) 或下划线 (
___
为了兼容性,分隔线的前后均需添加空白行。
效果如下:
3.11 链接
Markdown 支持两种类型的链接:行内式和参考式。
不管是哪一种,链接文本都写在[方括号]内。
行内式链接
要创建行内式链接,将链接文本括在方括号中,后面紧跟着一组圆括号。在圆括号内,输入URL地址,以及可选的用双引号括起来的链接Title。若想链接本地其他文件,可以使用相对路径。
链接Title是当鼠标悬停在链接上时会出现的文字,这个Title是可选的,它放在圆括号中链接地址后面,跟链接地址之间以空格分隔。
Markdown | HTML |
---|---|
[超链接显示名](超链接地址 "超链接Title") | \超链接显示名\ |
效果如下:
也可以将 URL 或email地址作为链接插入,用尖括号 < >
括起来即可。例如:\https://markdown.com.cn
效果如下:
自动将URL转换为链接
许多 Markdown 解析器会自动将 URL 转换为链接。这意味着,即使没有使用方括号,如果输入 http://www.example.com
,Markdown 解析器也会自动将其转换为链接。
http://www.example.com
效果如下:
如果不希望URL自动转为链接,则可以通过反引号将URL表示为代码。
http://www.example.com
参考式链接
参考式链接是一种特殊的链接,它使得URL在Markdown中更易于显示和阅读。参考式链接由两部分组成:与文本保持内联的部分以及存储在文件中其他位置的部分。
参考式链接第一部分的格式
参考式链接的第一部分由两组括方号组成。第一组方括号内放的是显示为链接的文本。第二组括号内放的是一个标签,该标签用于指向您存储在文档其他位置的链接。
This is [an example][id] reference-style link.
效果如下:
This is an example reference-style link.
可以选择性地在第一组和第二组方括号之间添加一个空格。第二组方括号中的标签不区分大小写,可以包含字母、数字、空格或标点符号。
参考式链接第二部分的格式
引用式链接的第二部分为链接标签的定义,链接标签定义的格式为:
-
放在方括号内的标签,方括号后紧跟一个冒号和至少一个空格或制表符(例如 id: )。
-
链接的 URL,可以选择性将其括在尖括号内。
-
链接的标题(可有可无),可以将其括在双引号、单引号或括号内。
[id]: <https://markdown.com.cn/> "markdown"
效果如下:
链接的第二部分可以放在Markdown文档中的任何位置。例如将它们放在被引用的段落的后面,或是将它们放在文档的末尾(类似尾注或脚注)。
隐式链接标签名功能允许您省略链接的标签名,在这种情况下,链接标签名默认为链接文本本身。只需在链接文本后添加一组空的方括号[ ]
。
[Google][]
然后定义链接标签
[Google]: http://google.com/
链接到标题ID
Markdown语法中,通过创建标准链接(即 井号#
+标题自定义ID) ),从而链接到ID对应的标题。
Markdown | HTML | 效果 |
---|---|---|
[标题ID](#custom-id) | \标题ID | 标题ID |
注意:Typora采用(井号
#
+标题名)的方式,为文档中对应名称的标题创建一个书签,Ctrl + 单机 该链接将跳转到对应标题。例如:标题自定义ID
其他网站网站也可以通过将标题自定义ID添加到网页的完整的URL之后来链接到对应的标题
[Heading IDs](https://markdown.com.cn/extended-syntax/heading-ids.html#headid)
效果如下:
强调链接
如需[强调](#3.4 强调)某个链接, 请在链接语法前后(即方括号前及圆括号后)添加星号。要将链接表示为[代码](#3.7 代码),请在方括号内添加反引号。
I love supporting the **[EFF](https://eff.org)**.
This is the *[Markdown Guide](https://www.markdownguide.org)*.
See the section on [`code`](#code)
效果如下:
I love supporting the EFF.
This is the Markdown Guide.
See the section on code
3.12 图片
要添加图片,首先请添加感叹号(!),然后紧跟着是方括号,方括号中可选择性地添加替代文本(alt text,即图片显示失败后显示此文本),最后跟着圆括号,圆括号中添加图片链接(本地资源的路径或 URL地址)。可以选择性地在圆括号中图片之后添加图片 ‘title’ 。
![Sylvanas](Markdown语法教程.assets/Sylvanas.jpg)
效果如下:
带链接的图片
给图片添加链接,请将图像的Markdown 语句括在方括号中,然后紧跟着一组圆括号,并在圆括号中添加链接地址。。
[![](Markdown语法教程.assets/google.png)](http://google.com/)
效果如下:
视频
要添加视频,使用HTML中的\
<video src="xxx.mp4" />
3.13 转义字符
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,请在字符前面添加反斜杠字符 \
用于转义特殊符号。
\* 如果没有开头的反斜杠字符的话,这一行将显示为无序列表。
效果如下:
* 如果没有开头的反斜杠字符的话,这一行将显示为无序列表。
可做转义的字符
字符 | 名称 |
---|---|
\ | 反斜杠 |
` | 反引号 |
* | 星号 |
_ | 下划线 |
{ } | 花括号 |
[ ] | 方括号 |
< > | 尖括号 |
( ) | 园括号 |
# | 井号 |
+ | 加号 |
– | 减号 |
. | 英文句点 |
! | 感叹号 |
| | 管道符 |
3.14 HTML
对于 Markdown 涵盖范围之外的标签,都可以直接在文档里面用 HTML 撰写。如需使用 HTML,不需要额外标注这是 HTML 或是 Markdown,只需 HTML 标签添加到 Markdown 文本中即可。
HTML更便于修改元素属性,如文本颜色、图像宽度等。
区块标签
HTML 中的区块元素――比如 <div>
、<table>
、<pre>
、<p>
等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 会自动识别这区块元素,避免在区块标签前后加上不必要的 <p>
标签。
在 HTML 区块标签内不能使用Markdown 语法。例如:在 HTML 区块内使用 Markdown 样式的*强调*会没有效果。
行内标签
HTML 的行內(区段)标签如 <span>
、<cite>
、<del>
不受限制,可以在 Markdown 的段落、列表或是标题里任意使用。依照个人习惯,甚至可以不用 Markdown 格式,而采用 HTML 标签来格式化。例如:如果比较喜欢 HTML 的 <a>
或 <img>
标签,可以直接使用这些标签,而不用 Markdown 提供的链接或是图片语法。
HTML 行內标签和区块标签不同,Markdown 语法在 HTML 行内标签间内是有效的。
3.15 脚注
脚注是对文本的补充说明。脚注用于添加注释和参考,而不会使文档正文混乱。当创建脚注时,带有脚注的上标数字会出现在引用脚注的位置。读者可以单击链接以跳至页面底部的脚注内容处。
要创建脚注引用,请在方括号[ ]
内添加一个插入符号及一个标识符如:[^1]。标识符可以是数字或字母,但不能包含空格或制表符。标识符的作用仅是将脚注引用与脚注本身相关联。在输出中,脚注按顺序编号。
另一种创建脚注的方式是在括号内添加一个插入符号和数字,后面紧跟冒号和文本即([^1]: My footnote.)。采用这种方式,不必在文档末尾添加脚注。可以将脚注放在除列表,块引用和表格之外的任何位置。
创建脚注格式类似这样 [^1]。
[^1]: 脚注内容
效果如下:
创建脚注格式类似这样 ^1。
注意:脚注自动被搬运到最后面,请到末尾查看,并且脚注后方的链接可以直接跳转回到加注的地方。
3.16 Emoji表情
有两种方式可以将表情符号添加到 Markdown 文档中:
- 将表情符号复制并粘贴到 Markdown 格式的文本中
- 键入表情符号的简码(emoji shortcodes)。
复制并粘贴表情符号
在大多数情况下,可以简单地从 Emojipedia 等来源复制表情符号,然后将其粘贴到文档中。许多 Markdown 应用程序会自动以 Markdown 格式的文本来显示表情符号。从 Markdown 应用程序导出的 HTML 和 PDF 文件也是可以显示表情符号的。
如果使用的是静态站点生成器,请确保HTML页面的字符编码为UTF-8。
使用表情符号的简码(Shortcodes)
一些 Markdown 应用程序允许通过键入表情符号的简码(shortcodes)来插入表情符号。简码以冒号开头和结尾,两个冒号中间是表情符号的名称。
Gone camping! :tent: Be back soon.
That is so funny! :joy:
效果如下:
Gone camping! :tent: Be back soon.
That is so funny! :joy:
可以使用这个 表情符号简码列表,查询简码。
四、Typora相关操作
4.1 Typora快捷键
文件快捷键
操作 | 快捷键 |
---|---|
新建 | Ctrl+N |
新建窗口 | Ctrl + Shift + N |
打开 | Ctrl + O |
快速打开 | Ctrl + P |
重新打开关闭的文件 | Ctrl + Shift + T |
保存 | Ctrl + S |
另存为 | Ctrl + Shift + S |
偏好设置 | Ctrl + , |
关闭 | Ctrl + W |
打印 | Alt + Shift + P |
编辑快捷键
操作 | 快捷键 |
---|---|
新建段落 | Enther |
新建行 | Shift + Enther |
撤 | Ctrl + Z |
重做 | Ctrl + Y |
剪切 | Ctrl + X |
复制 | Ctrl + C |
粘贴 | Ctrl + V |
复制为 Markdown | Ctrl + Shift + C |
粘贴为纯文本 | Ctrl + Shift + V |
全选 | Ctrl + A |
选择段落或块 | Alt + Ctrl + P |
删除段落或块 | Alt + Ctrl +Shift + P |
选择当前行/句子 | Ctrl + L |
删除当前行/句子 | Alt + Shift + L |
选择当前格式文本 | Ctrl + E |
删除当前格式文本 | Alt + Shift + E |
选中当前词 | Ctrl + D |
删除当前词 | Cttl + Shift + D |
跳转至文首 | Ctrl + Home |
跳转至所选内容 | Ctrl + J |
跳转至文末 | Ctrl + End |
查找 | Ctrl + F |
查找下一个 | F3 |
查找上一个 | Shift + F3 |
替换 | Ctrl + H |
段落快捷键
操作 | 快捷键 |
---|---|
1-6级标题 | Ctrl + 1/2/3/4/5/6 |
段落 | Ctrl + 0 |
提升标题等级 | Ctrl + = |
降低标题等级 | Ctrl + – |
表格 | Ctrl + T |
下方插入行(表格) | Ctrl +Enter |
上移该行(表格) | Alt + ↑ |
下移该行(表格) | Alt + ↓ |
左移该列(表格) | Alt + ← |
右移该列(表格) | Alt + → |
删除行(表格) | Ctrl + Shift + Backspace |
代码块 | Ctrl + Shift + K |
公式块 | Ctrl + Shift + M |
引用 | Ctrl + Shift + Q |
有序列表 | Ctrl + Shift + [ |
无序列表 | Ctrl + Shift + ] |
任务列表 | Ctrl + Shift + X |
增加缩进(列表) | Ctrl + [ |
减少缩进(列表) | Ctrl + ] |
格式快捷键
操作 | 快捷键 |
---|---|
加粗 | Ctrl + B |
斜体 | Ctrl + I |
下划线 | Ctrl + U |
代码 | Ctrl + Shift + ` |
删除线 | Alt + Shift + 5 |
超链接 | Ctrl + K |
插入图片 | Ctrl + Shift + I |
清除样式 | Ctrl + \ |
视图快捷键
操作 | 快捷键 |
---|---|
显示/隐藏侧边栏 | Ctrl + Shift + L |
大纲 | Ctrl + Shift + 1 |
文档列表 | Ctrl + Shift + 2 |
文件树 | Ctrl + Shift + 3 |
搜索 | Ctrl + Shift + F |
源代码模式 | Ctrl + / |
专注模式 | F8 |
打字机模式 | F9 |
切换全屏 | F11 |
实际大小 | Ctrl + Shift + 9 |
放大 | Ctrl + Shift + = |
缩小 | Ctrl + Shift + – |
在打开的文档之间切换 | Ctrl + Tab |
切换开发工具 | Shift + F12 |