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 官方中文站 .
      • 至于盗版以及破解方法在此随便找一种改注册表时间方法的不介绍(还挺多的其实).
      • 还有一种免费白嫖的方法就是安装测试版/Beta版. 官网有历史版本的下载链接 Typora 历史版本下载页
      • 白嫖Beta版已经寄了, 要么支持正版要么去学习一下破解方法吧 (还是忍不住啦, 看上面的链接👆)
      • Typora激活方法（2023年最新版）
  • VS Code
    • 这是微软家的开源文本编辑器, 理论上来说所有代码, 语言, 都可以用 VS Code 来写, 同样是非常的简洁好用. 在下载插件 Markdown All in One 后对 Markdown 的基础支持也是非常的好. 若在 VS Code 下载 Markdown 各种附加扩展, 就能获得比 Typora 更加丰富的扩展语法与操作.
  • 基础教程
    • 写 Markdown 的第零步
      • 我们写文本的时候大多写的是中文, 可是输入法在输中文时使用的标点为全角标点, 如 ，。？！（）【】：；“”. 这些标点是不被 Markdown 所认可的, 也是无法转义的.
      • 我建议大家写 Markdown 的时候都用半角标点, 即英文标点, 如 ,.?!()[]:;"". 且每个半角标点在文本使用时加上后置空格, 符合英文标点的书写规范, 也更加美观.
      • 以微软自带输入法举例, 在使用中文输入法时按下 Ctrl + .(这是个句号), 切换标点的全角与半角. 这样即可中文输入+半角标点.

  • 标题 [数个 “#” + 空格 前置]

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
  • 标题会在目录与大纲分级显示, 可以跳转.
  •  Typora 中建议开启 严格模式, 即不应为 #标题, 应为 # 标题.
  • 应该要手动补上空格, 使得 Markdown 语法在其他文本编辑器上兼容.

  • 强调 [用 ““ 或 “__” 包围]**

1
2
**欢迎报考南京大学!** (我喜欢用这种)
__欢迎报考南京大学!__

  • 斜体 [用 ““ 或 “_” 包围]*

1
2
*欢迎大佬来浇浇我各种知识* (我喜欢用这种)
_欢迎大佬来浇浇我各种知识_

  • 删除线 [用 “~~” 包围]

1
~~我宣布个事儿, 我是Sabiyary!~~

  • 高亮 [用 “==” 包围]

1
==我喜欢黄色, 也喜欢绿色==

  • 代码 [用 “`” 包围]

1
`sudo rm -rf /*`

  • 代码块 [按三个 “`” 并敲回车]

1
2
3
4
5
6
7
// 这里就可以开始输入你要的代码了
#include <stdio.h>
int mian() {
    print（“Hello, world!\n"）;
    retrun O;
}
// (这三个"`"文本编辑器会帮你自动补全 一般不用手动输)

  • 引用 [“>” + 空格 前置]

1
2
> 24岁, 是学生.
> > 学生特有的无处不在(恼)
  • 引用是可以嵌套的!
  • E.G.

  • 24岁, 是学生.

    学生特有的无处不在(恼)

  • 无序列表 [“-“ 或 “+” + 空格 前置]

1
2
3
- 一颗是枣树 (我喜欢用这种)
+ 另一颗还是枣树
* (其实这种也可以, 不过由于在 Typora 中很难单个输入, 故不常用)
  • E.G.
  • 一颗是枣树 (我喜欢用这种)
  • 另一颗还是枣树
  • (其实这种也可以, 不过由于在 Typora 中很难单个输入, 故不常用)

  • 有序列表 [数字 + “.” + 空格 前置]

1
2
3
4
我来这里就为了三件事:
1. 公平
2. 公平
3. 还是tm的公平!
  • 敲回车会自动补全, 敲回车后按下 Tab 会缩进一级.
  • E.G.
    我来这里就为了三件事:
  1. 公平
  2. 公平
  3. 还是tm的公平!

  • 上标 [用 “^” 包围]*(注意: 此为扩展语法)

1
C语言中int的上限是 2^31^ - 1 = 2147483647
  • E.G.
  • C语言中int的上限是 2^31^ - 1 = 2147483647

  • 下标 [用 “~” 包围](注意: 此为扩展语法)

1
H~2~O 是剧毒的!
  • E.G.
  • H2O 是剧毒的!

  • 注释 [“[^]” 后置](注意: 此为扩展语法)

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 的设置里也可以改图片的储存方式.
  • E.G.
  • xy

  • 分割线 [按三个 ““ 或 “-“ 或 “_” 并敲回车]*

1
2
3
4
***
--- (我喜欢用这种)
___
// (其实按三个及以上都可以)
  • 由于 * 与 _ 均会自动补全, 所以我觉得 - 最为方便.
  • E.G.

  • Emoji表情 [“:” 前置]

1
2
3
4
:sweat_smile: 
:drooling_face:
:clown_face:
// (敲回车或者鼠标点击, 后置的":"一般不需要手动输)
  • 这个功能唯一的要求就是英语水平要高, 或者大概记得各个 Emoji 的英文名.
  • E.G.

  • 🔥 进阶教程

  • 目录 [自动生成]

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.

$\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}
$$