Markdown 快速入门

在 CSDN 学习中心 内学习课程 CS 入门技能树 第二章节 Markdown 入门时突发想法而写。

能够让你写文章的东西很多。最原始的就是 Notepad / Vim 这类纯文本编辑器，随着技术的发展，富文本编辑器出现了。富文本编辑器给人们更多的自由度，让人可以随心所欲的调整文档，使文档成为自己想要的样子。

但有的时候，选择过多也是一种问题。我们可能会陷入一种困境：希望自己的文档独一无二且美观大气的同时做出内容和界面都很难看的文档。（做 PPT 的时候感受出来的）

直到我遇到了 Markdown 。它语法简单易懂、在纯文本的基础之上为文字添加了样式的同时又不影响原本文档的可读性。在使用 Markdown 一个月后，我便直接的将我的主力文档编辑器从 Word 换成了 Markdown。

什么是 Markdown

Markdown - Wikipedia
Markdown is a lightweight markup language for creating formatted text using a plain-text editor. John Gruber created Markdown in 2004 as a markup language that is easy to read in its source code form. Markdown is widely used for blogging and instant messaging, and also used elsewhere in online forums, collaborative software, documentation pages, and readme files.
The initial description of Markdown contained ambiguities and raised unanswered questions, causing implementations to both intentionally and accidentally diverge from the original version. This was addressed in 2014 when long-standing Markdown contributors released CommonMark, an unambiguous specification and test suite for Markdown.

Markdown 可以说是在纯文本的基础之上、在保持可阅读性的前提上构建而成的一种 标记语言。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的网页文档。Markdown 吸收了很多在电子邮件中已有的纯文本标记的特性。

Markdown 编写简单、源文件内容的可读性好、对常用的文本格式都有支持。将纯文本文档转换成 Markdown 只需要在原文本上进行少量的修改和添加即可。

而在开发中，最常见的 Markdown 文件莫过于 README.md 了。

为什么会想使用 Markdown

因为 Markdown 语法简单且易用。能够让我写作的时候注意力集中在文字而不是格式上。

Markdown 本身提供的功能也是很全面的。熟练之后其实能够发现原来的所有常用的功能 Markdown 都能够实现。

如何编辑 Markdown

Markdown 可以使用纯文本的编辑器来书写。但我还是会推荐去使用一些专门的 Markdown 编辑器。编辑器可以提供一些常用格式的快捷键调用。也可以提供可视化预览 / 所见即所得。

说人话就是专事专干，用的舒服就行。

常见的支持 Markdown 的编辑器

也算是用过挺多的笔记软件 / Markdown 编辑器了。简单的说一下我用过的那些软件吧。

anytype ( https://anytype.io/ )

笔记软件，体验类似 Notion 和 Obsidian 的结合体。目前的笔记主力。

开箱即用的端到端加密云端同步。数据默认存放在本地，支持导入导出。软件整体体验一般但是开发团队活跃，可以尝鲜但没必要完全迁移。

支持 Markdown 语法。

Obsidian ( https://obsidian.md/ )

笔记软件，注重知识库之间的联系。

支持 Markdown 语法。（也可以说是在 Markdown 语法上增添了一些自己的功能）

支持所见即所得。（编辑时在原文上直接预览格式）

数据默认存在本地，没去折腾过笔记的云端同步。

Joplin ( https://joplinapp.org/ )

笔记软件，结构类似于 OneNote 。支持 Markdown 语法，分为编辑区和预览区。拥有自己的富文本编辑器模式。

数据可以使用 WebDav 同步，也可以使用软件开发商提供的云服务。可以跨端 / 跨设备同步。

MarkText ( https://github.com/marktext/marktext )

Markdown 编辑器，开源、简单、轻便、美观。

支持所见即所得。仅支持 PC 平台。

Typora ( https://typora.io/ )

Markdown 编辑器。旧版本免费，新版本需要购买。

可以说是我用过的体验最好的 Markdown 编辑器。

支持所见即所得。

Visual Studio Code ( https://code.visualstudio.com/ )

代码编辑器，但是可以通过插件来实现 Markdown 格式的预览 + 快捷键。

不算正经的 Markdown 编辑器

• Notepad 一类的纯文本编辑器
• Vim / NeoVim / Notepad++ 一类的拥有语法高亮功能的文本编辑器

Markdown 基本语法

这部分仅包含我所掌握的 Markdown 语法，更详细的内容还请自行查阅下方的参考资料。

可供参考的资料

Markdown Cheat Sheet (markdownguide.org) | Markdown 教程 (runoob.com) | Markdown 介绍 (edu.csdn.net)

具体代码	实际效果	备注
*<斜体文字>*	<斜体文字>	样式之间都可以互相组合
**<粗体文字>**	<粗体文字>
~~删除线~~	删除线
‵行内代码块‵	行内代码块	不是单引号，是键盘上 Tab上方的那个
[超链接显示文字](超链接实际链接)	CSDN 官网	超链接可以使用粗体 / 斜体装饰 在超链接前方加上英文感叹号就可以作为 图片 / 视频来导入
# 一级标题	*表格内无法显示	标题最多设置 6 级，但是我基本只用到 3 级
> 引用内容	*表格内无法显示	换行的时候跟普通 Markdown 一样，都是两段之间加一段空行
- 无序号列表	*表格内无法显示
1. 有序号列表	*表格内无法显示	跟正常自己手写序号一样，但是要求字符都是英文的 会自动缩进到相同位置
- [ ] 带有复选框的列表	*表格内无法显示	类似 Todo 一样的复选框 在两个方括号内写 x 可以勾选

一些小贴士

• Markdown 在某种程度上也会支持一定的 HTML 语法。有些编辑器可能会因为安全原因禁止使用特定的标签。

• 手动创建分割线

  创建一个空行，在里面输入连续的三个以上的 * / - 即可创建分割线。

• 创建表格

  |表头 1|表头 2|表头 3|
  |---|---|---|
  |第一行的内容|第一行第二列|第一行第三列|
  |第二行的内容|第二行第二列|第二行第三列|
  |第三行的内容|第三行第二列|第三行第三列|
  

  效果：

  表头 1	表头 2	表头 3
  第一行的内容	第一行第二列	第一行第三列
  第二行的内容	第二行第二列	第二行第三列
  第三行的内容	第三行第二列	第三行第三列

  注意：表头和内容的分界线一定要有，长度不限。

• 创建代码块

  	```<使用的语言名称>
  	代码内容
  	```
  

  在一些 Markdown 语法中，开头输入四个空格也能代表代码块。