版权声明:本文为 stormlei 的原创文章,可以随意转载,但必须在明确位置注明出处!!!
导语:
Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑,Markdown 的语法十分简单。常用的标记符号也不超过十个,这种相对于更为复杂的 HTML 标记语言来说,Markdown 可谓是十分轻量的,学习成本也不需要太多,且一旦熟悉这种语法规则,会有一劳永逸的效果。
一、认识 Markdown
Markdown 官方文档
这里可以看到官方的 Markdown 语法规则文档,当然,后文我也会用自己的方式阐述这些语法的具体用法。
使用 Markdown 的优点
- 专注你的文字内容而不是排版样式,安心写作。
- 轻松的导出 HTML、PDF 和本身的 .md 文件。
- 纯文本内容,兼容所有的文本编辑器与字处理软件。
- 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。
- 可读、直观、学习成本低。
使用 Markdown 的误区
We believe that writing is about content, about what you want to say – not about fancy formatting.
我们坚信写作写的是内容,所思所想,而不是花样格式。
— Ulysses for Mac
- Markdown 旨在简洁、高效,也由于 Markdown 的易读易写,人们用不同的编程语言实现了多个版本的解析器和生成器,这就导致了目前不同的 Markdown 工具集成了不同的功能(基础功能大致相同),例如流程图与时序图,复杂表格与复杂公式的呈现,虽然功能的丰富并没有什么本质的缺点,但终归有些背离初衷,何况在编写的过程中很费神,不如使用专业的工具撰写来的更有效率,所以如果你需实现复杂功能,专业的图形界面工具会更加方便。当然,如果你对折腾这些不同客户端对 Markdown 的定制所带来高阶功能感到愉悦的话,那也是无可厚非的。
二、Markdown 语法的简要规则
标题
# 一级标题
## 二级标题
### 三级标题
以此类推,总共六级标题。
粗体、斜体、删除线和分割线
Markdown 的斜体、粗体和分割线也非常简单,用一个 * 包含一段文本就是斜体的语法,用二个 * 包含一段文本就是粗体的语法,用三个个 * 包含一段文本就是分割线的语法。
*这里是斜体*
**这里是粗体**
这里是分割线 ***
~~这里是删除线~~
列表
无序列表
- 1
- 2
- 3
有序列表
1. 1
2. 2
3. 3
引用
> 这里是引用
链接和图片
插入链接与插入图片的语法很像,区别在一个 ! 号。
链接为:[]()
图片为:![]()
代码框
如果你是个程序猿,需要在文章里优雅的引用代码框,在 Markdown下实现也非常简单,只需要用两个 ` 把中间的代码包裹起来。
单行:function test() {}
多行:
class ProductsController < ApplicationController
def index
@projects = Product.all
respond_to do |format|
format.html # index.html.erb
format.json {render josn: @projects}
end
end
end
表格
表格是我觉得 Markdown 比较累人的地方,例子如下:
|这里是表头|这里是第二列|这里是第三列|
|:-|:-:|-:|
|第二行|第二列|第三列|
|第三行|第二列|第三列|
|第四行|第二列|第三列|