MarkDown使用手册

目录

一、概述

什么是MarkDown?

  • Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。
  • Markdown 语言在 2004 由 John Gruber 创建。
  • Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
  • Markdown 编写的文档后缀为 .md, .markdown。
  • Markdown 能被使用来撰写电子书，如：Gitbook。
    当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如：GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

简而言之, Markdown 是一种语言, 是一种语法. 以 .md 结尾的文本文件就是 Markdown 文件.

相较于 Word, 它更加像是 HTML 语言或是 LaTeX, 并不是最淳朴的那种"所见即所得".

它处处透露着一种极简主义, 高效简洁清晰的同时, 又很简单. 看起来舒服, 语法简单, 尤其在处理纯文本上有很大的优势.

相较于 Word, 它的兼容性非常高, 可以跨平台使用, 不用担心奇奇怪怪的版本兼容问题.

同时, 有许多网站都支持或正在使用 Markdown 语法. 如 Github (等一系列代码托管平台), StackOverflow(等答疑平台), 简书, 语雀 (等一系列笔记平台).

二、应用

所有要写文本的时候都可以用上 Markdown

它可以让你不再纠结什么字体, 什么样式, 什么排版, 而且逻辑清晰, 层次分明.

可以用 Markdown 来写各种笔记, 演讲稿, 课程论文, 实验报告, 代码的 README.md ... 包括本教程文档.

它能让人优雅地沉浸式记录，专注内容而不是纠结排版，达到「心中无尘，码字入神」的境界。

三、编辑器

用来编写 Markdown 的文本编辑器主要是 Typora 和 VS Code，这两个各有优缺点

  • Typora
    Typora 是最被广泛用于编写 Markdown 的文本软件, 就和 Markdown 语法一样简洁且高效.
    而且它还有很实用的扩展语法与自定义样式的功能.
    能将 .md 导出成多种文件, 如 .pdf, .html, .docx
    现在 Typora 已经发布正式版并且变为收费软件.
    中文官网在此 Typora 官方中文站 .
    至于盗版以及破解方法
    https://www.only4.work/blog/?id=379
    http://t.csdn.cn/3crjQ
    在此不多介绍

  • VS Code

    VSCode（全称：Visual Studio Code）是一款由微软开发且跨平台的免费源代码编辑器.
    VSCode 支持 MacOS 、Windows、Linux 平台，且包含多种主题.
    VSCode 默认集成了 Markdown 文档编辑插件，原生就支持高亮 Markdown 的语法.
    在下载插件 Markdown All in One 后对 Markdown 的基础支持也是非常的好.
    若在 VS Code 下载 Markdown 各种附加扩展, 就能获得比 Typora 更加丰富的扩展语法与操作.

  • 其他

    大部分IDE, 像 Jetbrain 的全家桶里应该每一款都支持 Markdown 语法, 在此不多赘述.

  • 在线编辑器
    https://c.runoob.com/front-end/712/
    https://markdown.com.cn/editor/

本文档主要介绍在 Typora 下的 MarkDown 使用和 Typora 所包含的扩展语法.

四、基础教程

标题有 * 表示该为扩展语法, 仅在 Typora 或 添加了扩展的 VS Code 本地生效, 在大多数平台上并不认可.

0. 写 Markdown 的第零步

我们写文本的时候大多写的是中文, 可是输入法在输中文时使用的标点为全角标点,
如 ，。？！（）【】：；“”. 这些标点是不被 Markdown 所认可的, 也是无法转义的.

我建议大家写 Markdown 的时候都用半角标点, 即英文标点,
如 ,.?!()[]:;"". 且每个半角标点在文本使用时加上后置空格, 符合英文标点的书写规范, 也更加美观.

以微软自带输入法举例, 在使用中文输入法时按下 Ctrl + ., 切换标点的全角与半角. 这样即可中文输入+半角标点.

1. 标题 [数个 "#" + 空格 前置]

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

标题会在目录与大纲分级显示, 可以跳转.

在 Typora 中建议开启 严格模式, 即不应为 #标题, 应为 # 标题.

应该要手动补上空格, 使得 Markdown 语法在其他文本编辑器上兼容.

2. 强调 [用 "**" 或 "__" 包围]

**这是一个强调语句!** 
__这是一个强调语句!__

或者选中想要强调的文字按下 Ctrl + B.

E.G.

这是一个强调语句!

3. 斜体 [用 "*" 或 "_" 包围]

*我的字是斜着的* 
_我的字是斜着的_

或者选中想要强调的文字按下 Ctrl + I.

E.G.

我的字是斜着的

P.S.

斜体并强调 [用 "***" 或 "___" 包围]

4. 删除线 [用 "~~" 包围]

~~请无视我~~

E.G.

请无视我

5. *高亮 [用 "==" 包围]

(注: 此为扩展语法)

==我喜欢黄色==

E.G.

我喜欢黄色

6. 代码 [用 "`" 包围]

`sudo rm -rf /*`

E.G.

sudo rm -rf /* (没事别乱敲这个。。。)

7. 代码块 [按三个 "`" 并敲回车]

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

要想显示行数的话, 一般要在 Typora 的设置里勾上这个显示行数的选项.

代码块里可以选择语言, 其会根据语言来自动高亮各个语句. 在选择语言后, ``` 会变为 ```` + 对应语言.

8. 引用 [">" + 空格 前置]

> 漠上雁送归鸿
> > 良人似初分

引用是可以嵌套的

E.G.

漠上雁送归鸿

良人似初分

9. 无序列表 ["-" 或 "+" + 空格 前置]

- 一颗是枣树
+ 另一颗还是枣树
* (其实这种也可以, 不过由于在 Typora 中很难单个输入, 故不常用)

三种前置符都可以, 敲回车会自动补全, 可在 Typora 设置中调整补全的符号, 敲回车后按下 Tab 会缩进一级.

E.G.

  • 一颗是枣树
  • 另一颗还是枣树

10. 有序列表 [数字 + "." + 空格 前置]

1. 首先
2. 其次
3. 最后

敲回车会自动补全, 敲回车后按下 Tab 会缩进一级.

E.G.

  1. 首先

  2. 其次

  3. 最后

11. *上标 [用 "^" 包围]

(注意: 此为扩展语法)

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

E.G.

C语言中 int 的上限是 231 - 1 = 2147483647

12. *下标 [用 "~" 包围]

(注意: 此为扩展语法)

H~2~O 是一氧化二氢

E.G.

H2O 是一氧化二氢

13. *注释 ["[^]" 后置]

(注意: 此为扩展语法)

> 今日我们相聚于此, 是为了学习 Markdown 的使用, 它的教程对于全体「观众」而言, 值得足足两个硬币的支持鼓励![^1]

[^1]: 沃兹·基·硕德 改编自「公鸡」普契涅拉.

需要在文末写上注释对应的内容

E.G.

今日我们相聚于此, 是为了学习 Markdown 的使用, 它的教程对于全体「观众」而言, 值得足足两个硬币的支持鼓励![1]

14. 链接 [常用 "[ ]" + "( )" 分别包围文本与链接]

(注意: 文内跳转为扩展用法)

[博客BlickWinkel](https://www.cnblogs.com/BlickWinkel/)

支持网页链接与文内跳转, 按住 Ctrl 并 单击鼠标左键 即可跳转.

E.G.

博客BlickWinkel

15. 任务列表 ["- [ ]" + 空格 前置]

TodoList:
- [ ] 刷B站
- [ ] 写代码
- [x] 起床

用 x 代替 [ ] 中的空格来勾选任务列表. 在 Typora 中可以直接用鼠标左键单击勾选框.

E.G. TodoList:

16. 表格 [用 "|" 绘制表格边框]

| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|(引号的位置代表着 左对齐, 居中对齐, 右对齐)
| col 3 is      | some wordy text | $1600 |
| col 2 is      | centered        |   $12 |
| zebra stripes | are neat        |    $1 |

第一行为表头, 并由第二行分割线决定对齐方式与长度, 第三行及之后即表格数据

E.G.

Left-Aligned Center Aligned Right Aligned
col 3 is some wordy text $1600
col 2 is centered $12
zebra stripes are neat $1

17. 图片 [直接拖进来或者复制粘贴]

![图片](图片的位置)

我还是会选择拖进来或者复制粘贴啦~ 在 Typora 的设置里也可以改图片的储存方式.

18. 分割线 [按三个 "*" 或 "-" 或 "_" 并敲回车]

***
--- 
___
// (其实按三个及以上都可以)

E.G.

19. Emoji表情 [":" 前置]

(注意: 英文输入为扩展语法)

:sweat_smile: 
:drooling_face:
:clown_face:
// (敲回车或者鼠标点击, 后置的":"一般不需要手动输)

这个功能唯一的要求就是英语水平要高, 或者大概记得各个 Emoji 的英文名.

E.G.

😅
🤤
🤡

对于其余普通的 Markdown 文本编辑器, 可以直接将 Emoji 表情复制进来, 这是直接硬编码的

用这个功能可以让你的文本变得更加可爱 也可能变得更抽象

这里分享一个可以复制全Emoji的网站

五、进阶教程

1. 目录 [自动生成]

[TOC] (此为 Typora 特有的, 如本文档开头)

若使用 VS Code 搭配 Markdown All in One 扩展, 可在 VS Code 的命令面板 (即 VS Code Command Palette) 输入 Create Table of Contents 自动生成目录, 且可在扩展设置中细调目录参数.

2. 内联 HTML 代码 [用 "<> </>" 包围]

<div style="text-align:center">
  <font style="color:red">其实我不会 HTML</font>
</div>

<center>文字居中也可以这样</center>

<u>还有下划线...</u>

只要你会写, 你完全可以把 Markdown 当作 HTML 来写.

同时, .md 文件可以直接导出成一个网页.

下划线可以选中想要下划的文字按下 Ctrl + U.

E.G.

其实我不会 HTML
文字居中也可以这样

还有下划线...

3. 内联 \(\LaTeX\) 公式 [用 "$" 包围]

(注意: 部分编译器会不识别部分符号)

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

4. *网络图床

分享一个 Typora 搭配腾讯云COS/阿里云OSS图床的例子. 新用户免费试用6个月, 另外还可选择七牛云或者路过图床.

5. *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 + + 放大视图缩放

还有一些不常用的/三键的快捷键不在此列出.

6. *Typora 的主题样式与检查元素

Markdown 在编译后约等于 HTML. 而 Typora 的正常视图就是编译后的 Markdown, 故Typora的主题样式本质就是 CSS 文件.

可以下载各种好看的主题给 Typora换上, 同时也可以自己调整对应的 CSS 文件, 或者自己手搓.

在 Typora 设置中开启 调试模式 后即可在正常视图右击打开 检查元素, 在其中就可以完全将 Markdown 文件当成 HTML 来编辑.

六、总结

至此, Markdown 的手册教程告一段落.

Markdown 只是标记语言的最开始, 在学会了 Markdown 之后对于理解 HTML , 对于用 \(\LaTeX\) 来写论文都有帮助.
标记语言正是为了摆脱 Word 那种虽然"所见即所得", 但又过于花哨浮华, 很差的兼容性与闭源的编码的缺陷.
当你能掌握这样的"所写即所得"时, 你肯定会感受到用 Markdown 这类语言来处理文本的妙处

七、参考

Typora 的 Markdown 语法
MarkDown官方教程
Typora使用教程|Typora中文网
MarkDown教程|菜鸟教程

  1. 沃兹·基·硕德 改编自「公鸡」普契涅拉. ↩︎

posted @ 2023-04-15 19:52  氢氧正根  阅读(104)  评论(0)  编辑  收藏  举报