MarkDown - 入门指南

96
IUVO
2017.01.02 15:29* 字数 2438
写在前面:这是我自己学习MarkDown的一篇文章,我直接按照原来的格式去写一份,边写文章边学MarkDown,原文可以参考这位大神的。

概述

MarkDown是一个十分便利的轻量级的标记语言,他的优点很多,目前也被越来越多的写作爱好者、撰稿者广泛使用。看到标记语言,很多人会马上想到HTML,二者有相同之处,但是还是存在很大的差异的,MarkDown的使用是十分Easy,不要担心如何去学习和使用。常用的MarkDown的标记符号,也就那么寥寥几个。学习起来基本不需要什么学习成本,掌握后,也可为一劳永逸,对于以后的书写,能够有很大裨益。

一、认识 MarkDown

正如我们前面所提到的,MarkDown是一个轻量级的便利的标记语言,它用简洁的语法代替排版,而不是像Word这类软件,使用大量的排版和文字设置去达到我们所期望的效果。它让我们可以专心的码字,用标记的语法,替代常见的排版格式,甚至插图、表格都可以直接在键盘上搞定。目前支持MarkDown的语法的编辑器有很多,很多网站也已经支持MarkDown的文字入录,例如我现在使用的简书。MarkDown从写作到完成,导出格式随心所欲(这个我暂时不会...),你可以导出HTML格式的文件用来网站发布(这个我还是不会...),也可以十分方便的导出PDF格式(就没一个我会的...),这种格式写出的简历更能得到HR的好感(为什么...?)。甚至可以利用 CloudApp 这种云服务工具直接上传至网页用来分享你的文章,全球最大的轻博客平台Tumblr,也支持Mou这类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 的定制所带来高阶功能感到愉悦的话,那也是无可厚非的。

[flowchart.js on Github(使用 Markdown 绘制流程图](https://github.com/adrai/flowchart.js)
[flowchart.js on Github(使用 Markdown 绘制流程图](https://github.com/adrai/flowchart.js)

PS:上图的文字链接,就是在图片的链接中,用图片名字的方括号,再去套一个链接,从而实现的效果。

我该用什么工具

Mou for Mac
  • 在 Mac OS X 上,我个人推荐使用 Mou 这款免费(也快不免费了,现在要出1.0版本,$30呢...,预售只要$15)并且十分好用的 MarkDown 编辑器,它支持实时预览,既左边是你编辑的 MarkDown 语言,右边会有实时预览效果,很直观。不仅如此,Mou 还有一些有趣的偏好设置(Preference),例如主题(Themes)与样式(CSS)(关于这个CSS,估计也有的玩),它们可以配置出定制化的文本编辑效果与导出效果,如果你对自带的主题与样式不满意还可以到 GitHub 上去搜索其他的爱好者为 Mou 编写的更多主题样式(可玩性很强的样子),导入的方式可以在偏好设置的 Themes 或 CSS 选项中 选择 reload。
    Mou的编写与预览窗口

如果你从事专业的文字工作,我强烈建议你购买Ulysses for Mac,这款软件入围了苹果Mac App Store 的 The Best of 2013。它支持更多的写作格式、多文档的支持。Mou,iAwriter 这些软件都是基于单文档的管理方式,而Ulysses 支持Folder、Filter 的管理,一个Folder里面可以创建多个Sheet,Sheet之间也可以进行Combine处理。

Mac 上一些 MarkDown 编辑器

  • 由于笔者很少基础Windows,Windows 下的 MarkDown 没有过多的涉猎,经朋友介绍,有两款还算不错,一款叫做 MarkDownPad,另一款叫做 MarkPad。
  • iOS 端很多的App早已经支持了MarkDown录入,例如Drafts,Day One,iA writer 等,另外 Ulysses for iPad 现在已经上架,可以说是 iOS 平台最好的编辑器了。
  • 在Web端,我个人强烈建议使用简书这款产品,上面有无数热爱文字的人在不停的创造,分享。在 Web 端使用 Markdown 没有比简书更舒服的地方了,同样支持左右两栏的实时预览,字体优雅,简洁。
    简书编辑模式的预览

二、Markdown 语法的简要规则举例

标题

6种标题格式

标题是每篇文章都需要,也是最常用的格式,在 Markdown 中,如果想要把一段文字定义为标题,很简单,只要在前面添加上#号即可。
# 一级标题

## 二级标题

### 三级标题

(PS:实现上诉效果,在语句中加上" ` "把你要的内容包含起来即可,其本意是使用它来包含代码)

以此类推,总共六级标题,建议在#号后面加一个空格,这是最标准的MarkDown语法。

列表

熟悉HTML的童鞋肯定知道有序列表和无序列表的区别,在 MarkDown 下,列表的显示只要在文字前加上-*+号即可变成无序列表,注意加个空格。有序列表则直接在文字前加上1. 2. 3.符号依旧要和文字之间加上一个空格。

无序列表和有序列表

引用

如果你需要引用一小段别的例子,那么就要用引用格式。

例如这样

只需要在文本前加入>这种尖括号就可以。
PS:刚开始我一直琢磨怎么退出引用区域,后面发现,多回车一行,即留一个空行,就可以退出引用区域。

引用

图片和链接
插入图片和插入连接语法基本一样,就一个!号的差异,插入图片要!号,插入连接不要。
插入图片格式:![](//图片地址){ImgCap}{/ImgCap}
插入连接格式:[//链接名](//链接地址)

插入图片的地址需要图床(这是啥?),这里推荐 围脖图床修复计划CloudApp的服务,生成URL地址即可。

URL和图片

粗体与斜体

Markdown 的粗体和斜体的语法很非常简单,用两个*号括起来即可,其中:用一对*号括起来的,是斜体,用一对**括起来的是粗体。
例如:这是粗体 这是斜体

表格

Tables Areas Cool
col2 col2 col2
col2 col2 col2
col2 col2 col2 `

表格我觉得是 Markdown 中最累人的语法,举个例子你看看就知道了:
`

Tables Areas Cool
col2 col2 col2
col2 col2 col2
col2 col2 col2 `

总之 很恶心就是了。

dog bird cat
foo foo foo
baz baz baz

这种语法生成的表格如下

dog bird cat
foo foo foo
baz baz baz

(PS:我没做出来......)

代码框

如果你是个程序猿,需要在文章间优雅的引用代码狂,在 Markdown 下实现也非常简单,只要用一对`` `把中间的代码包裹起来。如图:


引用代码

使用tab键即可缩进

分割线

分割线的语法很简单,只要三个*号即可,例如:


到了这里,Markdown 的基本语法在日常的使用中基本没有什么大的问题了,只要多加练习,配上好用的工具,写起东西肯定会行云流水,更多的语法规则,其实Mou的Help文档例子很好,当你第一次使用Mou时,就会显示该文档,可以拿来对照学习使用用。


Mou的Help文档

三、相关推荐:

工具

图床工具用来上传图片获取URL地址

在线好用的 Markdown 工具,为印象笔记而生

随笔