-
Notifications
You must be signed in to change notification settings - Fork 0
/
05markdown_guide.md
113 lines (67 loc) · 7.65 KB
/
05markdown_guide.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
---
title: "【Markdown】零基础入门Markdown：一种轻量级标记语言"
author: GarytheNoob
date: 2023/01/27 00:00
update: 2023/01/27 13:30
mathjax: true
math: true
categories:
- 技术
- Markdown
tags:
- 技术
- Markdown
---
这篇文章将一站式带你认识并了解Markdown及其用法。但是不会过多赘述Markdown的语法细节。
<!-- more -->
Markdown是一种「**语言**」，也是一种文件格式。也就是说，表达相同的意思，可以用Markdown也可以不用。
那它究竟是一种什么「语言」呢？使用它有什么优势呢？接下来我会简单介绍。
{% note info %}
请注意，本文就是基于Markdown编写的，但是添加了一些不属于原版Markdown的语法（比如现在你看到的这个蓝色的卡片）。如果你想访问本文的源文件，[可以点我](https://github.com/GarytheNoob/GarytheNoob.github.io/blob/master/source/_posts/05markdown_guide.md?plain=1)。
{% endnote %}
## 开始前回答几个问题
### 何为Markdown？有何优势？
Markdown和Word等软件的用法最大的不同，在于Markdown是**所见非所得**的。在Word中，我们习惯于利用上方的工具栏为我们的文字修改格式和排版，而这些操作的**结果会实时在屏幕上显示**，所以我们说Word是一种**所见即所得**的编辑软件（请注意，Markdown不是「软件」而是「语言」，即使经常被用来和Word比较）。而Markdown则不一样，使用Markdown编辑文字时，所有的格式修改都需要用特殊的符号标记来设置。
这就导致了Markdown和Word在操作上的区别。在Markdown中，你的手完全不用离开键盘，也就是说，输入不会被打断。并且你输入的只是纯文本，甚至字体、大小这种设置都没有，只是**纯粹的文字**。所有的**加粗**、*斜体*、~~删除线~~都只是在键盘上输入几个符号就能搞定的。
这样带来了两个好处：
- **连续的输入流** 正如刚刚所说的那样，手无须离开键盘，只需要专心打字。
- **标准统一的格式** 所有的排版都不需要自己动手，各个渲染器会帮你排版，让所有的格式都标准有序。
但是也有弊端：
- **单一的排版** Markdown的排版大多都像本文这样，是一长串文字。不像在其他编辑器中可以做到不一样的效果，比如分栏、文本框等。正如刚刚所说，Markdown处理的是**纯粹的文字**。
### 一定要用Markdown替代Word吗？
**完全没必要！**
首先，Markdown和Word对于文字处理各有所长。Word主打直观方便，而Markdown则更简单有效率。所以我个人不是很赞同网络上的所谓「放弃Word吧，来用Markdown」的观点——两家各有所长，需要分情况。
Markdown作为一种轻量的标记语言，很适合写博客（比如本文）或者一些简单的说明。在GitHub中，Markdown更是广泛使用[^1]。
[^1]:[GitHub的中文版Markdown文档](https://docs.github.com/zh/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)
使用Markdown可以很轻松地完成简单的排版，且效果高级，操作简单。通过软件的导出功能更是可以导出为PDF或者Word文档，甚至直接导出为图片。
## 编辑Markdown前准备
正如一些编程语言需要自己的「编译器」，Markdown作为语言也需要专门的编辑器，所以选择一款编辑器是很重要的。
{% note info %}
刚刚提到，Markdown处理的是纯文本，所以理论上可以用系统自带的**文本编辑器**来打开，比如Windows系统的**记事本**（Notepad），但是这些编辑器不能满足很多功能，比如渲染、高亮等，所以还是选一款专门的编辑器吧！
{% endnote %}
我现在正在使用的是微软的[Visual Studio Code](https://code.visualstudio.com/)（VS Code），这是一款**全能的**代码编辑器，当然也支持编辑Markdown。但是这款编辑器的配置难度较高（本质上是依赖安装扩展实现不同功能），小白上手可能略显困难。但是相信如果配置得好，这款编辑器一定可以满足编写Markdown的所有需求。
### VS Code安装简要步骤
下面我简要说明一下安装步骤，由于不是本文重点，节奏较快。如果不会可以去B站或百度搜索教程。
1. 首先从[上述官网](https://code.visualstudio.com/)下载VS Code，打开后点击左侧的**扩展**按键或按快捷键`Ctrl+Shift+X`打开扩展下载窗口，输入`Chinese`来搜索中文翻译，选择第一个安装即可。安装完后需要重启VS Code。
2. 理论上原版的VS Code已经可以编辑Markdown，但是安装接下来几个扩展之后编辑会变得更顺畅。以下扩展只需要搜索`Markdown`就可以搜索得到，点击下载即可。
- Markdown All in One：Markdown编辑工具全家桶
- Markdown Preview Enhanced：Markdown白底预览
3. 到这一步，你的VS Code已经具备了流畅编写Markdown的能力，接下来就是新建文件然后一展身手了！你可以新建一个文本文件，将后缀名改为`.md`，这是Markdown文件的后缀。然后用VS Code打开，就可以愉快开始Markdown编写了！在编写界面的右上角，你可以找到一个预览按钮（在安装了Markdown Preview Enhanced扩展之后可以按快捷键`Ctrl+K V`打开，这是一个两段快捷键，先按`Ctrl+K`再单独按`V`）。
如果我说的太抽象，可以去B站或百度搜索「Markdown VS Code」的关键词寻找教程！
### VS Code以外的平替
如果不熟悉或者不习惯VS Code的界面，也可以用这些专门为Markdown设计的编辑器：
- [Obsidian](https://obsidian.md/)：一款免费的笔记软件，支持Markdown编辑。
- [Typora](https://typora.io/)：简洁好用的Markdown阅读器和编辑器，但是收费。
个人除了VS Code以外强烈推荐Typora，~~在互联网上也可以找到破解版~~ **有能力请支持正版！** Typora相比于VS Code，上手难度更低，更接近Word的所见即所得模式，也就是所有的语法实时渲染。在网上有很多Typora的下载、安装、设置教程，可以自己去看看。
如果目前只是想尝试Markdown编辑或者由于某些原因无法下载软件，可以使用一些在线编辑器。这些编辑器都大同小异，任意选择即可。
- [StackEdit](https://stackedit.io/app#)
- [Editor.md](https://pandao.github.io/editor.md/index.html)
这些在线编辑器可能默认已经有了简要的Markdown教程。如果你想跟着本文接下来的教程走，建议先全选删除页面中原有的内容。
甚至，在本博客的评论区也支持Markdown语法。如果你想尝试Markdown，欢迎你在下面的评论区试一试。点击评论区左下角的最后一个带放大镜的图标，可以打开Markdown渲染预览。祝玩得愉快！
## Markdown语法
请见另一篇[Markdown基本语法](https://garythenoob.github.io/06markdown_grammar_book)
## 导出
在Typora中，可以方便地将Markdown导出为自己需要的格式，比如PDF或者Word文档，也可以直接生成图片。
在VS Code中，可以通过一个扩展[Markdown PDF](https://marketplace.visualstudio.com/items?itemName=yzane.markdown-pdf)来实现导出操作。虽然名字中有PDF，但是其实它不仅能导出为PDF文件，还可以导出为图片和html文件。
安装了Markdown PDF扩展之后，在需要导出的文件的编辑页面按右键选择Markdown PDF: Export相关选项，即可在`.md`文件所在目录生成导出文件。
请注意，Markdown PDF扩展本质上也是一个渲染器，并且渲染效果和Markdown Preview Enhanced的效果不同，所以可能需要自己设置。