00:00:00
Markdown
😂 简要介绍
Markdown 是一种轻量型标记语言, 是一种语法. 以 .md 结尾的文本文件就是 Markdown 文件. 相较于 Word , 它更加像是 HTML 语言或是 , 并不是最淳朴的那种”所见即所得 “. 它处处透露着一种极简主义. 高效简洁清晰的同时, 又很简单. 看起来舒服, 语法简单, 尤其在处理纯文本上有很大的优势.
它相较于 Word , 兼容性非常高, 可以跨平台使用, 不用担心奇奇怪怪的版本兼容问题. 同时, 有许多网站都支持或正在使用 Markdown 语法. 如 Github (等一系列代码托管平台), StackOverflow(等答疑平台), 简书, 语雀 (等一系列笔记平台).
📐 实际应用
所有要写文本的时候都可以用上 Markdown!
它可以让你不再纠结什么字体, 什么样式, 什么排版. 而且逻辑清晰, 层次分明.
像我大一的时候就用 Markdown 来写各种笔记, 演讲稿, 课程论文, 实验报告, 代码的 README.md … 包括本教程文档.
🍴 工具
Markdown 只是一种语法. 那么用来写 Markdown 的文本编辑器呢? 我推荐的是 Typora 或者 VS Code
Typora
Typora 应该是被广泛用于写 Markdown 的文本软件, 就和 Markdown 语法一样高效. 而且它还有很实用的扩展语法与自定义样式的功能. 其能将 .md 导出成多种文件, 如 .pdf, .html, .docx (没想到吧, 能导出到 Word)
但是现在 Typora 已经发布正式版并且变为收费软件. 中文官网在此 Typora 官方中文站 .
我当然是推荐大家都用正版啦. 不过价格是永久版￥89, 好在可以用在3台设备上. 如果和你的两位同学/舍友均摊一下, 每人就只要￥30, 和一张游戏月卡差不多.
至于盗版以及破解方法[在此随便找一种改注册表时间方法的]不介绍(还挺多的其实).
白嫖Beta版已经寄了, 要么支持正版要么去学习一下破解方法吧 (还是忍不住啦, 看上面的链接👆)
VS Code
这是微软家的开源文本编辑器, 理论上来说所有代码, 语言, 都可以用 VS Code 来写, 同样是非常的简洁好用. 在下载插件 Markdown All in One 后对 Markdown 的基础支持也是非常的好. 若在 VS Code 下载 Markdown 各种附加扩展, 就能获得比 Typora 更加丰富的扩展语法与操作.
其他
大部分IDE, 像 Jetbrain 的全家桶里应该每一款, 都支持 Markdown 语法, 在此不多赘述.
本文档主要使用 Typora 进行演示, 同时会介绍许多 Typora 所包含的扩展语法.
🍭 基础教程
当有多种标记方法时我会倾向其中一种.
标题有 * 表示该为扩展语法, 仅在 Typora 或 添加了扩展的 VS Code 本地生效 , 在大多数平台上并不认可.
写 Markdown 的第零步
我们写文本的时候大多写的是中文, 可是输入法在输中文时使用的标点为全角标点, 如 ，。？！（）【】：；“”. 这些标点是不被 Markdown 所认可的, 也是无法转义的.
我建议大家写 Markdown 的时候都用半角标点, 即英文标点, 如 ,.?!()[]:;"". 且每个半角标点在文本使用时加上后置空格, 符合英文标点的书写规范, 也更加美观.
以微软自带输入法举例, 在使用中文输入法时按下 Ctrl + .(这是个句号), 切换标点的全角与半角. 这样即可中文输入+半角标点.
标题 [数个 “#” + 空格 前置]
1
2
3
4
5
6
|
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
---|---
标题会在目录与大纲分级显示, 可以跳转.
在 Typora 中建议开启 严格模式, 即不应为 #标题, 应为 # 标题.
应该要手动补上空格, 使得 Markdown 语法在其他文本编辑器上兼容.
强调 [用 “**” 或 “__” 包围]
1
2
|
**欢迎报考郑州大学!** (我喜欢用这种)
__欢迎报考郑州大学!__
---|---
或者选中想要强调的文字按下 Ctrl + B.
或者选中想要强调的文字按下 *
E.G.
欢迎报考郑州大学!
斜体 [用 “*” 或 “_” 包围]
1
2
|
*欢迎大佬来浇浇我各种知识* (我喜欢用这种)
_欢迎大佬来浇浇我各种知识_
---|---
或者选中想要强调的文字按下 Ctrl + I.
或者选中想要强调的文字按下 *
E.G.
欢迎大佬来浇浇我各种知识
(P.S. 斜体并强调 [用 “***” 或 “___” 包围])
删除线 [用 “~~” 包围]
1
|
~~我宣布个事儿, 我是Sabiyary!~~
---|---
或者选中想要强调的文字按下~
E.G.
我宣布个事儿, 我是Sabiyary!
*高亮 [用 “==” 包围]
(注意: 此为扩展语法)
1
|
==我喜欢黄色, 也喜欢绿色==
---|---
或者选中想要强调的文字按下 =
E.G.
==我喜欢黄色, 也喜欢绿色==
代码 [用 “`” 包围]
1
|
`sudo rm -rf /*`
---|---
或者选中代码按ESC键下面
E.G.
sudo rm -rf /* (没事别乱敲这个! )
“请输入管理员密码: (闪烁的光标)”
代码块 [按三个 “`” 并敲回车]
1
2
3
4
5
6
7
8
|
```
// 这里就可以开始输入你要的代码了
#include <stdio.h>
int main() {
printf（"Hello, world!\n"）;
retrun 0;
}
``` // (这三个"`"文本编辑器会帮你自动补全 一般不用手动输)
---|---
(我之前都是用这个来展示各种语法的, 应该不用举例了吧)
要想显示行数的话, 一般要在 Typora 的设置里勾上这个显示行数的选项.
代码块里可以选择语言, 其会根据语言来自动高亮各个语句. 在选择语言后, ````` 会变为 `````` + 对应语言.
引用 [“>” + 空格 前置]
1
2
|
> 24岁, 是学生.
> > 学生特有的无处不在(恼)
---|---
引用是可以嵌套的!
E.G.
24岁, 是学生.
学生特有的无处不在(恼)
无序列表 [“-“ 或 “+” + 空格 前置]
1
2
3
|
- 一颗是枣树 (我喜欢用这种)
+ 另一颗还是枣树
* (其实这种也可以, 不过由于在 Typora 中很难单个输入, 故不常用)
---|---
三种前置符都可以, 敲回车会自动补全, 可在 Typora 设置中调整补全的符号, 敲回车后按下 Tab 会缩进一级.
E.G.
- 一颗是枣树
- 另一颗还是枣树
有序列表 [数字 + “.” + 空格 前置]
1
2
3
4
|
我来这里就为了三件事:
1. 公平
2. 公平
3. 还是tm的公平!
---|---
敲回车会自动补全, 敲回车后按下 Tab 会缩进一级.
E.G.
我来这里就为了三件事:
公平
公平
还是tm的公平!
*上标 [用 “^” 包围]
(注意: 此为扩展语法)
1
|
C语言中int的上限是 2^31^ - 1 = 2147483647
---|---
E.G.
C语言中 int 的上限是 2^31^ - 1 = 2147483647
*下标 [用 “~” 包围]
(注意: 此为扩展语法)
1
|
H~2~O 是剧毒的!
---|---
E.G.
H2 O 是剧毒的!
*注释 [“[^]” 后置]
(注意: 此为扩展语法)
1
2
3
|
> 今日我们相聚于此, 是为了学习 Markdown 的使用, 它的教程对于全体「观众」而言, 值得足足两个硬币的支持鼓励![^1]
[^1]: 沃兹·基·硕德 改编自「公鸡」普契涅拉.
---|---
需要在文末写上注释对应的内容
E.G.
今日我们相聚于此, 是为了学习 Markdown 的使用, 它的教程对于全体「观众」而言, 值得足足两个硬币的支持鼓励![^1]
[^1]: 沃兹·基·硕德 改编自「公鸡」普契涅拉.
链接 [常用 “[ ]” + “( )” 分别包围文本与链接]
(注意: 文内跳转为扩展用法)
1
2
|
[来看看我贫瘠的仓库罢](https://github.com/Sakiyary)
[基础教程: 12. 下标](#12. 下标 [用 "~" 包围])
---|---
支持网页链接与文内跳转, 按住 Ctrl 并 单击鼠标左键 即可跳转.
E.G.
[基础教程: 12. 下标](#12. 下标 [用 “~” 包围])
任务列表 [“- [ ]” + 空格 前置]
1
2
3
4
|
TodoList:
- [ ] 刷B站
- [ ] 写代码
- [x] 起床
---|---
用 x 代替 [ ] 中的空格来勾选任务列表. 在 Typora 中可以直接用鼠标左键单击勾选框.
E.G. TodoList:
- 刷B站
- 写代码
- 起床
表格 [用 “|” 绘制表格边框]
1
2
3
4
|
| 学号 | 姓名 | 年龄 |
| :--- | :---: | ---: | (引号的位置代表着 左对齐, 居中, 右对齐)
|114514|田所|24|
|1919810|浩三|25|
---|---
第一行为表头, 并由第二行分割线决定对齐方式与长度, 第三行及之后即表格数据
E.G.
| 学号 | 姓名 | 年龄 |
|---|---|---|
| 114514 | 田所 | 24 |
| 1919810 | 浩三 | 25 |
图片 [直接拖进来或者复制粘贴]
1
|
---|---
我还是会选择拖进来或者复制粘贴啦~ 在 Typora 的设置里也可以改图片的储存方式.
分割线 [按三个 “*” 或 “-“ 或 “_” 并敲回车]
1
2
3
4
|
***
--- (我喜欢用这种)
___
// (其实按三个及以上都可以)
---|---
由于 * 与 _ 均会自动补全, 所以我觉得 - 最为方便.
E.G.
Emoji表情 [“:” 前置]
(注意: 英文输入为扩展语法)
1
2
3
4
|
:sweat_smile:
:drooling_face:
:clown_face:
// (敲回车或者鼠标点击, 后置的":"一般不需要手动输)
---|---
这个功能唯一的要求就是英语水平要高, 或者大概记得各个 Emoji 的英文名.
E.G.
😅
🤤
🤡
对于其余普通的 Markdown 文本编辑器, 可以直接将 Emoji 表情复制进来, 这是直接硬编码 的 (刻进DNA里)
E.G.
😅🤤🤡
用好这个功能可以让你的文本非常的可爱! 太抽象了
这里分享一个可以复制全Emoji的网站, 非常好用! 我之前的C语言大作业也是从这里下载的资源!
🔥 进阶教程
目录 [自动生成]
1
|
[TOC] (此为 Typora 特有的, 如本文档开头)
---|---
若使用 VS Code 搭配 Markdown All in One 扩展, 可在 VS Code 的命令面板 (即 VS Code Command Palette) 输入 Create Table of Contents 自动生成目录, 且可在扩展设置中细调目录参数.
内联 HTML 代码 [用 “<> </>” 包围]
1
2
3
4
5
6
7
|
<div style="text-align:center">
<font style="color:red">我不会 HTML 呜呜呜... 浇浇我</font>
</div>
<center>简单的文字居中也可以这样</center>
<u>我差点忘了还有下划线这东西...</u>
---|---
只要你会写, 你完全可以把 Markdown 当作 HTML 来写.
同时, .md 文件可以直接导出成一个网页.
下划线可以选中想要下划的文字按下 Ctrl + U.
E.G.
我不会 HTML 呜呜呜... 浇浇我
简单的文字居中也可以这样
我差点忘了还有下划线这东西…
内联 公式 [用 “$” 包围]
(注意: 部分编译器会不识别部分符号)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
$\LaTeX$ 是最好用的论文排版语言! 不信你看!
$a^n+b^n=c^n$
$$
%\usepackage{unicode-math}
\displaystyle \ointctrclockwise\mathcal{D}[x(t)]
\sqrt{\frac{\displaystyle3\uppi^2-\sum_{q=0}^{\infty}(z+\hat L)^{q}
\exp(\symrm{i}q^2 \hbar x)}{\displaystyle (\symsfup{Tr}\symbfcal{A})
\left(\symbf\Lambda_{j_1j_2}^{i_1i_2}\Gamma_{i_1i_2}^{j_1j_2}
\hookrightarrow\vec D\cdot \symbf P \right)}}
=\underbrace{\widetilde{\left\langle \frac{\notin \emptyset}
{\varpi\alpha_{k\uparrow}}\middle\vert
\frac{\partial_\mu T_{\mu\nu}}{2}\right\rangle}}_{\mathrm{K}_3
\mathrm{Fe}(\mathrm{CN})_6} ,\forall z \in \mathbb{R}
$$
---|---
用 $ 包围为单条公式, 按下两个 $ 并敲回车即生成公式块.
E.G.
是最好用的论文排版语言! 不信你看!
π
(注意: 本网站中使用的是Mathjax的插件，尽管MathJax借鉴了LaTeX的语法，但它并不支持所有LaTeX功能。MathJax主要集中在数学公式的呈现上，而不是完整的文档结构或微调排版。不支持\ointctrclockwise逆时针方向的环路积分符号，故将代码中的\ointctrclockwise改为\oint)
*网络图床
分享一个 Typora 搭配腾讯云COS/阿里云OSS图床的例子. 新用户免费试用6个月, 另外还可选择七牛云或者路过图床.
*Typora 的常用快捷键
| 按键 | 效果 | 按键 | 效果 |
|---|---|---|---|
Ctrl + D | 选中当前词 | Ctrl + L | 选中当前句/行 |
Ctrl + E | 选中当前区块 | Ctrl + F | 搜索当前选中 |
Ctrl + B | 加粗当前选中 | Ctrl + H | 替换当前选中 |
Ctrl + I | 倾斜当前选中 | Ctrl + U | 下划当前选中 |
Ctrl + K | 将当前选中生成链接 | Ctrl + J | 滚动屏幕将选中滚至顶部 |
Ctrl + W | 关闭当前窗口 | Ctrl + N | 打开新窗口 |
Ctrl + O | 打开文件 | Ctrl + P | 搜索文件并打开 |
Ctrl + 回车 | 表格下方插入行 | Ctrl + , | 打开偏好设置 |
Ctrl + . | 切换全角/半角标点 | Ctrl + / | 切换正常/源代码视图 |
Ctrl + Shift + - | 缩小视图缩放 | Ctrl + Shift + + | 放大视图缩放 |
还有一些不常用的/三键的快捷键不在此列出.
*Typora 的主题样式与检查元素
Markdown 在编译后约等于 HTML. 而 Typora 的正常视图就是编译后的 Markdown, 故Typora的主题样式本质就是 CSS 文件.
可以下载各种好看的主题给 Typora换上, 同时也可以自己调整对应的 CSS 文件, 或者自己手搓.
在 Typora 设置中开启 调试模式 后即可在正常视图右击打开 检查元素, 在其中就可以完全将 Markdown 文件当成 HTML 来编辑.
💯 总结
至此, Markdown + Typora / VSCode 的手册教程也告一段落.
不知你看完这么长的教程/手册, 是否能体会到 Markdown 的精妙简洁之处呢?
其实 Markdown 只是标记语言的最开始, 我的感受是会了 Markdown 之后对于理解 HTML 也有帮助, 对于用 来写论文也有帮助. 标记语言正是为了摆脱 Word 那种虽然”所见即所得”, 但又过于花哨浮华, 很差的兼容性与闭源的编码的缺陷. 当你能掌握这样的”所写即所得”时, 你肯定会感受到用 Markdown 这类语言来处理文本的妙处!
评论