最近 UTCSSA 换用了新的论坛系统,同时也抛弃了以往论坛臃肿的富文本编辑器(Rich-text Editor)而采用了使用纯文本但是依然强大的 Markdown 编辑器。但是由于 Markdown 并没有提供一种直观的所见即所得(WYSIWYG, or what you see is what you get)的编辑方式,技术部网站组想在此介绍一下这种容易上手而且用得好可以提升文本编辑效率的 Markdown 语法。Markdown 不仅对于在论坛上发帖有帮助,在日常文本编辑中也很实用。
先贴一段来自维基百科的介绍:
Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯。它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML文档”。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。甚至Markdown能被使用来撰写电子书。
–摘自 Wikipedia
Markdown 语法
标题(H1 ~ H6)
# 一号标题 Heading 1
## 二号标题 Heading 2
### 三号标题 Heading 3
#### 四号标题 Heading 4
显示效果:
一号标题 Heading 1
二号标题 Heading 2
三号标题 Heading 3
四号标题 Heading 4
其实总共有 6 种标题,语法是 n 个 #
加上空格后跟标题。可以用来表示不同层级的标题,一般在一篇文章中 不建议使用 3 层以上的层级 以免给读者阅读造成困惑。如果你觉得一号标题显示出来过大,可以从二号标题开始使用。
粗体、斜体
**粗体** _斜体_ _**粗体加斜体**_
显示效果:
在我们的论坛系统中,你也可以使用快捷键快速将选中的文字加粗、加斜:
Windows / Linux:
macOS:
引用文字
> Markdown是一种轻量级标记语言…
显示效果(就是将文字显示在下方这个方框中):
超链接、图片
[Google](https://www.google.com)

显示效果(图片需要科学@上网才能显示)
添加超链接快捷键:
Windows / Linux: Ctrl
+ K
macOS: ⌘K
列表
无序列表:
- 第一项
- 第二项
- 第三项
有序列表:
1. first
2. second
3. third
显示效果:
无序列表:
有序列表:
- first
- second
- third
推荐编写 Markdown 的工具
- Typora (Windows / macOS / Linux): 一个所见即所得的 Markdown 编辑器。
- MWeb (macOS / iOS)
- Markdown 在线编辑器 (任何支持浏览器的平台)
结语
除了我在上文中提到的语法,Markdown 还有很多其他的语法可以实现诸如行内代码、代码片段等功能。同时 Markdown 至今没有被标准化,有很多变体和扩展语法,比如我最喜欢的 macOS 上的笔记应用 Bear 就使用了一种类似 Markdown 但不尽相同的语法。由于 GitHub 程序员社区对于 Markdown 的广泛应用,现在比较流行的 Markdown 语法为 GFM (GitHub Flavored Markdown) ,其中大多数语法都被 UTCSSA 论坛支持。如果有需要,大家可以在上面链接中了解更多的 Markdown 语法并尝试。