Hello,world!

文科的格调 + 工科的背景 = 爱浪漫的程序媛

关于 Markdown 你可能想知道的

写在最前面的话

本文参考了很多大神的 Markdown 入门教程,旨在推广,不标原创。所引部分参考文献列于文末,如有疏漏,还请海涵。

文中介绍的 Markdown 语法为最常用的基础语法,每种标签的语法表达不止一种方式,这里只选用了最常用的一两种,更多语法格式请参考文末给出的官方文档链接内容。

认识 Markdown

小幻比较懒,这里直接引用一下其他大神的说法。

Markdown是Aaron Swartz 跟John Gruber共同设计的一种轻量级「标记语言」。Markdown 的理念是,让文档更容易读、写和随意改。它用简洁的语法代替排版,而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字,用「标记」语法,来代替常见的排版格式。

Markdown 的输出格式比较自由,可以是 HTML ,可以是 PDF 文件,有些编辑工具甚至提供了Word文件格式。这样自由的输出仅次于 LaTex ,而 Markdown 相对于 LaTex 的一大优点是,Markdown 是一门 5 分钟就能够学会的标记语言。LaTex需要多久,小幻不知道,因为小幻到现在都没学会。

我们为什么要用 Markdown

1. 避免编辑疯掉

如果你有过给他人文档排版的经验,尤其是那种把多个人的文档进行整合排版的经验,你一定明白这个标题的意思。使用富文本(可以理解为带格式的文本)编辑器得到的文档,在合并时,会出现很多排版上的问题。一一解决这些问题,十分费神。而这种问题,并不是大家使用统一的文字处理软件例如 Word 就可以解决的,因为Word本身的版本差异,也会产生兼容性问题。

这也是小幻会介绍 Markdown 的最初原因,我们的分享群每月都会进行一次文章汇总,几十个人的文章分别发布在不同的平台上,汇总起来十分繁琐。即使每个人都将自己的文章按照模板整合进 Word 文档中,最后的汇总者仍然面临着大量的排版调整工作。

由于 Markdown 本身就是 txt,任何人都可以打开它,并且因为它只是带标记的纯文本,本身不带样式,因此不会因为版本问题而产生很严重的样式兼容性问题。其次,Markdown 向 HTML 或者 PDF 转换十分便捷。以上两个特点,使得 Markdown 在网络文字编辑方面十分占优势。

Markdown提供一个标准化的格式,让在线文本传播更简便。

2. 更加专注于写作内容本身

Markdown 只是标记语言,当它转换为 HTML 时,控制排版的是 CSS 样式文件,同样的 Markdown 文本配上不同的 CSS 样式,会展现出不同的 HTML 排版风格。网上有大量的基于 Markdown 排版的CSS样式文件,我们找到自己喜欢的即可,不用自己去写。因此对于写作者来说,使用Markdown的好处比起其他格式来说,更能专注在写作本身,将投入在排版上的精力节省下来,投入在写作本身,提高写作效率和创作体验。

阳志平在《Markdown写作浅谈》时说到:

  • 难以专心:写Word文档的时候,我们经常浪费大量时间在Word本身上,特别是那80%我们用不到的功能。比如,找借口,Word又出问题了;或者,又要升级了。其实,在内心偷笑,哈哈,可以偷懒了
  • 浪费力气在排版上:使用Word时,我们会花费大量力气去排版,试图让文档变得漂亮一些。是粗体还是斜体,是宋体还是黑体,对创作来说,有那么重要吗?
  • 难以自动的版本跟踪:每一位自杀的写作者的电脑文档里面,都必然有一个Word文档,从V1.0到V20.0的无数版本(如何优雅地进行版本追踪对于文科生来说,是一项进阶技能);
  • 难以共同协作:想想你让一位合作的编辑帮你改书有多么痛苦,一个Word文档来,一个Word去,极其难用的修订与审阅功能,你就理解了(此条适用于会批阅你文档的任何人,口头批阅不算);

Markdown帮助写作者提高写作效率,优化写作体验

Markdown 基本语法

Markdown 简单在于,掌握几项基本用法就可以顺利的完成写作任务,以下是几乎所有介绍 Markdown 入门的文章都会提到的几项基本语法。

  • 标题
  • 段落
  • 加粗
  • 斜体
  • 块引用
  • 链接
  • 图片
  • 列表
  • 分割线

标题

在标题行的最前面加上#号(英文半角字符,后面提到的所有符号都为英文半角),几个#号代表几个标题,最多可以到6级标题。部分编辑器会在标题文字前后都加上数量相等的#,效果是一样的。以下是样例:

标题1

标题2

标题3

标题4

标题5
标题6

源码:

# 标题1

## 标题2

### 标题3

#### 标题4

##### 标题5

###### 标题6

段落

在希望分段的地方空一行,即为分段。两段之间没有空行不会分段,这个不举例,自己试一下就好。

加粗

在希望加粗的文字前后加上**或者__效果相同,选用自己顺手的符号即可。

这里需要用粗体强调

这里需要用**粗体强调**。

斜体

在需要使用斜体的文字前后加上*或者_

粗体是两个星号,斜体是一个星号。

**粗体**是两个星号,*斜体*是一个星号。

块引用

在引用文字的第一行最前面加上一个>(像不像一个指示箭头?),整段文字都会以缩进形式显示

例如:

Markdown是Aaron Swartz 跟John Gruber共同设计的一种轻量级「标记语言」。Markdown 的理念是,让文档更容易读、写和随意改。

> Markdown是Aaron Swartz 跟John Gruber共同设计的一种轻量级**「标记语言」**。Markdown 的理念是,让文档更容易读、写和随意改。

链接

在你想要加链接的文字前后用中括号[ ], 然后紧接着加上URL网址链接,前后用小括号括住。

例如:

点击进入小幻的部落格

[点击进入小幻的部落格](http://hongbowei.com)

备注:这一条对于写公众号的朋友有点儿难弄,因为微信严格限制个人订阅号的链接引用。

图片

添加图片跟添加链接的方法差不多,格式是![图片名](图片超链接),图片要求提前上传到公网可以访问的空间,很多支持Markdown的在线编辑器会帮助作者通过可视化操作上传图片,就容易很多。

(以下是广告)

Follow

![Follow](http://t.cn/RJ8yzcq)

列表

Markdown里只有两种列表,有序列表与无序列表。有序列表每行前面是数字序号,无需列表是一个小符号。

有序列表是以(数字 + . + 空格)的格式来标记的,但是不需要数字有顺序,甚至一样也没关系。无序列表可以使用星号,加号或者减号(*、+、-)创建,它们三者效果都是一样的,但要注意符号与列表内容之间需要加空格。

有序列表示例

  1. 跟着小幻GTD:收集阶段-日常收集 | 时间管理
  2. 跟着小幻GTD:收集阶段-归拢材料 | 时间管理
  3. 跟着小幻GTD:Newbie,你准备好了吗? | 时间管理
  4. 跟着小幻GTD:如何成为一只 GTD newbie| 时间管理

1. 跟着小幻GTD:收集阶段-日常收集 | 时间管理
1. 跟着小幻GTD:收集阶段-归拢材料 | 时间管理
1. 跟着小幻GTD:Newbie,你准备好了吗? | 时间管理
1. 跟着小幻GTD:如何成为一只 GTD newbie| 时间管理

无序列表示例

  • 跟着小幻GTD:检查回顾-保障系统的有效运行 | 时间管理
  • 跟着小幻GTD:组织整理-建立好清单 | 时间管理
  • 跟着小幻GTD:处理阶段-清空工作篮 | 时间管理

* 跟着小幻GTD:检查回顾-保障系统的有效运行 | 时间管理
* 跟着小幻GTD:组织整理-建立好清单 | 时间管理
* 跟着小幻GTD:处理阶段-清空工作篮 | 时间管理

分割线

要添加分割线非常简单,直接在一个空行里打上三个星号(***)或者三个下划线(___)。

例如:


***


___

Markdown 编辑器

Markdown 编辑器有很多,以下推荐几款使用比较广泛的软件。

  • Mac平台:
    • Mou (开源项目,目前似乎已停止维护?)
    • MacDown(MacDown由开源项目Mou修改而来,这篇文章就是用MacDown写的)
    • ulysses(广受好评的工具,但是收费,小幻买不起反正)
  • Windows平台:推荐MarkdownPad(Win10系统使用时会遇到不能即时显示 HTML 预览的问题,安装组件可解决)
  • Web平台:
    • 简书(支持Markdown)
    • Wordpress(通过安装插件支持Markdown)
    • typora(全平台,这个是被推荐的,小幻自己没用过)
  • RStudio可作为写作科技论文与R语言编辑器选择,它是跨平台的
  • markdown-here借助Chrome插件,将gmai写作窗口变为Markdown在线写作窗口
  • 可以直接在线通过github撰写与提交Markdown文件,github有自动的版本跟踪功能,不用担心写废与找不到以前写的

Markdown 进阶

这里只讲一下进阶的 Markdown 可以做什么,其他的留待未来某天分享。

  1. Markdown + GitHub(或者其他版本管理工具)解决文档共享与版本自动跟踪问题
  2. Markdown + R 解决科学文档写作问题(可重现性,跨平台性,支持LaTex公式)
  3. 更多的 Markdown 写作技巧,参看阳志平的《Markdown写作浅谈

参考文献

这里给出Markdown语法的官方文档以及链接,其中,中文文档的末尾还附带了各个平台的免费工具介绍

发表评论

电子邮件地址不会被公开。 必填项已用*标注