Markdown——入门指南 - TeLee - 简书
Tuesday, August 15, 2017
9:23 PM
2014.04.17 21:14 打开App
转载请注明原作者，如果你觉得这篇文章对你有帮助或启发，也可以来请我喝咖啡。
**导语：
Markdown 是一种轻量级的「标记语言」，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。看到这里请不要被「标记」、「语言」所迷惑，Markdown 的语法十分简单。常用的标记符号也不超过十个，这种相对于更为复杂的 HTML 标记语言来说，Markdown 可谓是十分轻量的，学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。
Library iC10Ud On My Mac Daedalus Last 7 Days Ill Trash Introduction First Steps Finer Details Shortcuts And Other Tips Cloud GeekCar On My Mac 65 Daedalus External Folders Add Folder... First Steps Welcome to Ulysses for Mac - Overview Nice to see you here! By now you've probably skipped this introduction and.. Ok, but How DO Let's first get you some sense of direction. Here is an UI-overview from l... Sidebar: Groups & Filters Groups and filters are your main tools to keep your library organized. They're similar to Finder's folders and smart fol... Sheets All writing is done on Ulysses' sheets. Sheets are somewhat equivalent to classic documents, though they don't r... Editor: Plain Text Enhanced By now you should have noticed "all these funny characters" before headlines and within the text. You should also hav... Export: 360 Degree Semantics Now for the fun part: Ulysses can output your writing to a host of standard formats, such as Plain Text, RTF, HTML,.. Export: Styles In the Quick Export panel there's an option to switch between various export styles. Each style offers a predefined se... Attachments, Notes & Comments See the button with the paper-clip on the right of the toolbar? Click it to open a sheet's "attachment bar". Attachments... iCloud vs On My Mac By default, your texts will get stored on iCloud, making it available on all your devices running Ulysses. Of course you... Ulysses for iPad If you own Ulysses for iPad (and, frankly, [you should]), now is a good time to enable iCloud on your devices. You will... External Folders In External Folders, you can edit classic text and markdown files from anywhere on your Mac. As an example, you can p.. Q Search ## Sheets All writing is done on Ulysses' sheets. Sheets are somewhat equivalent to classic documents, though they don't require a "title" or a "file name" or such. You create sheets via or the new sheet button in toolbar. Sheets can hold any amount of text, and you can freely move sheets around and sort them at will. You can also select multiple sheets and glue them together ( ) . They will then behave as a single sheet in the editor, which is especially cool if you rather have a lot of small chunks than a single, monolithic wall of text. You can also split a sheet in two at the current cursor position (Edit Split at Selection), and merge two or more sheets together to form one (File > Merge Sheets). ### Added bonus Since sheets are likely to live in the vicinity of other sheets, we figured it would be nice if you could easily navigate between them — right from within the editor. There are keyboard shortcuts for this ( ) . You should try this now to get the hang of it. Just come back here, as we're about to look at the coot stuff.
Ulysses for Mac
一，认识 Markdown
在刚才的导语里提到，Markdown 是一种用来写作的轻量级「标记语言」**，它用简洁的语法代替排版，而不像一般我们用的字处理软件 _Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法，来代替常见的排版格式。例如此文从内容到格式，甚至插图，键盘就可以通通搞定了。目前来看，支持 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 的定制所带来高阶功能感到愉悦的话，那也是无可厚非的。

![Demo L with color coding ($-lows+a+e). T ry edi+inq me below Start My Operation Yes or No? n/a My Subroutine APPROVED REJECTED 1 Z 3 4 5 6 7 8 9 10 11 12 13 14 15 st=>start: Start I past:>http://www.google.comb e=>end: Endel future:>http://www.google.com opl=>operation: My Operation I past opZ=>operation: Stuff I current subl=>subroutine: My Subroutine I invalid cond=>condition: Yes or No? lapproved:>http://www.google.com c2=>condition: Good ideal rejected io=>inputoutput: catch something… Ifuture st->opl(right)->cond cond(yes, right)->c2 cond(no)->sub1C1eft)->op1 c2(yes)->io->e Good idea n/a catch something… Ende Stuff
flowchart.js on Github（使用 Markdown 绘制流程图）
我该用什么工具？
计算机生成了可选文字:
Mou for Mac

  • 在 Mac OS X 上，我强烈建议你用 Mou 这款免费且十分好用的 Markdown 编辑器，它支持实时预览，既左边是你编辑 Markdown 语言，右边会实时的生成预览效果。不仅如此，Mou 还有一些有趣的偏好设置（Preference），例如主题（Themes）与样式（CSS），它们可以配置出定制化的文本编辑效果与导出效果，如果你对自带的主题与样式不满意还可以到 GitHub 上搜索其它爱好者为 Mou 编写的更多主题样式，导入的方式可以在偏好设置的 Themes 或 CSS 选项中 选择 reload。

markdown—— 从 入 门 到 # rkdown 一 从 入 门 到 精 通 > [Markdown](http ： [//zh.wikipedia.org/wiki/Markdown](//zh.wikipedia.org/wiki/Markdown)) 是 一 种 轻 量 级 的 「 标 记 语 言 」 ， 它 的 优 直 很 多 ， 目 前 也 被 越 来 越 多 的 写 作 爱 好 者 ， 撰 稿 者 广 泛 使 用 。 看 到 这 里 请 不 要 被 「 标 记 」 、 「 语 言 」 所 迷 惑 ， Markdown 的 语 法 十 分 简 单 。 常 用 的 标 记 符 号 也 不 超 过 十 个 ， 这 种 相 对 于 更 为 复 杂 的 H L 标 记 语 言 来 说 ， Markdwon 可 谓 是 十 分 轻 量 的 ， 学 习 成 本 也 不 需 要 太 多 ， 且 一 旦 熟 悉 这 种 语 法 规 则 ， 会 有 一 劳 永 逸 的 效 果 。 在 刚 才 的 导 语 里 提 到 ， rkdown 是 一 种 用 来 写 作 的 轻 量 级 「 标 记 语 言 」 ， 它 用 简 洁 的 语 法 代 替 排 版 ， 而 不 像 一 般 我 们 用 的 字 处 理 软 件 厂 或 _Pages_ 有 大 量 的 排 版 、 字 体 设 置 。 它 使 我 们 专 心 于 码 字 ， 用 「 标 记 」 语 法 ， 来 代 替 常 见 的 排 版 格 式 。 例 如 此 文 从 内 容 到 格 式 ， 甚 至 插 图 ， 键 盘 就 可 以 通 通 搞 定 了 。 目 前 来 看 ， 支 持 rkd “ n 语 法 的 编 辑 器 有 很 多 ， 包 括 很 多 网 站 （ 例 如 [简 书 I([http://jianshu.io](http://jianshu.io))) 也 支 持 了 rkd “ n 的 文 字 录 入 。 rkdown 从 写 作 到 完 成 ， 导 出 格 式 随 心 所 欲 ， 你 可 以 导 出 HTML 格 式 的 文 件 用 来 网 站 发 布 ， 用 rkd “ n 写 出 的 简 历 也 可 以 十 分 方 便 的 导 出 F 格 式 更 能 得 到 HR 的 好 感 。 本 文 的 所 有 格 式 ， 内 容 也 是 用 rkdown 写 成 。 # la rkdown 官 方 文 档 》 这 里 可 以 到 官 方 arkdown 语 法 规 则 文 档 ， 当 然 ， 后 文 我 也 会 用 自 己 的 方 式 阐 述 这 些 语 法 的 具 体 用 法 。 啮 始 只 J G 厂 u 厂 厂 k “ 浯 法 说 明 刈 (http ： [//daringfirebaU.net/](//daringfirebaU.net/) proj ects/ma rkdown/syntax) _ [对阳厂k00“0中文版浯法说明刘（http ： [//wowubuntu.com/markdown/#list](//wowubuntu.com/markdown/#list)) # # # 使 用 a rkdown 的 优 点 _ 专 注 你 的 文 字 内 容 而 不 是 排 版 样 式 。 _ 轻 松 的 导 出 HTML 、 PDF 和 本 身 的 ． md 文 件 。 _ 纯 文 本 内 容 ， 兼 容 所 有 的 文 本 编 辑 器 与 字 处 理 软 件 。 * 可 读 ， 直 觋 。 适 合 所 有 人 的 写 作 语 言 。 # # 我 该 用 什 么 工 具 ？ ！ ou iconl(http ：[//mouapp.com/Mou_128.png](//mouapp.com/Mou_128.png)) 在 Mac OS × 上 ， 我 强 烈 建 议 你 用 [ 凹 ou ] （ http ： //mouapp ． com) 这 款 免 费 且 十 分 好 用 的 rkdown" 器 ， 它 支 持 实 时 预 览 ， 既 左 边 是 你 编 槲 larkdo “ 语 言 ， 右 边 会 实 时 的 生 成 预 览 效 果 ， 笔 者 文 章 就 是 ou 这 款 软 件 写 出 来 的 。 Markdown— 寻 语 ： 一 从 入 门 到 精 通 Markdown 是 一 种 轻 量 级 的 「 标 记 语 言 」 ， 它 的 优 点 很 多 》 目 前 也 被 越 来 越 多 的 与 作 爱 好 者 1 撰 稿 者 广 泛 使 用 。 看 到 这 里 请 不 要 被 r 标 记 」 、 「 浯 言 」 所 迷 惑 1 Markdown 的 语 法 十 分 简 单 。 常 的 标 记 符 号 也 不 超 过 十 个 ， 这 种 相 对 于 更 为 复 杂 的 HTML 标 记 语 言 来 说 ， Markdwon 可 谓 是 十 分 轻 量 的 ， 字 习 成 本 也 不 需 要 太 多 1 且 一 旦 熟 悉 这 种 浯 法 规 则 1 会 有 一 劳 永 逸 的 效 果 。 认 识 Markdown 在 对 才 的 寻 浯 里 提 到 1 Markdown 是 一 种 甲 来 写 作 的 轻 量 级 「 标 记 语 言 」 ， 它 甲 简 洁 的 浯 法 代 替 排 版 ， 而 不 像 一 般 我 们 用 的 字 处 理 软 件 Word 或 Pages 有 大 量 的 排 版 、 字 体 设 置 。 它 使 我 们 专 心 于 码 字 1 用 「 标 记 」 浯 法 1 来 代 替 常 见 的 排 版 格 式 。 例 如 此 文 从 容 到 格 式 1 甚 至 插 1 键 盘 就 可 以 通 通 搞 定 了 。 0 前 来 看 1 支 持 Markdown 语 法 的 编 辑 器 有 很 多 ， 包 括 很 多 网 站 （ 例 如 同 ） 也 支 持 了 Markdown 的 文 字 入 。 Markdown 从 与 作 到 完 成 ， 寻 出 格 式 陌 心 所 欲 ， 你 可 以 寻 出 HTML 格 式 的 文 件 用 来 网 站 发 布 1 用 Markdown 与 出 的 简 历 也 可 以 十 分 方 便 的 导 出 PDF 格 式 更 能 得 到 HR 的 好 感 。 本 文 的 所 有 格 式 1 容 也是 用 Markdowns 成 。 Markdowng 方 文 档 这 里 可 以 看 到 官 方 的 Markdown 语 法 规 则 文 档 ， 式 阐 述 这 些 浯 法 的 具 体 用 法 。 Gruber Markdown Markdown 使 '"Markdown 的 优 点 ． 专 注 你 的 文 字 ^ 容 而 不 是 排 版 样 式 。 ． 轻 松 的 导 出 HTML 、 PDF 和 本 身 的 ． md 文 件 。 当 然 》 后 文 我 也 会 甲 自 己 的 方 ． 纯 文 本 容 1 兼 容 所 有 的 文 本 编 辑 器 与 字 处 理 软 件 。 ． 可 读 1 直 观 。 适 合 所 有 人 的 与 作 浯 言 我 该 用 什 么 工 具 ？
Mou 的编写与预览窗口
如果你从事文字工作，我强烈建议你购买 Ulysses for Mac，这款软件入围了苹果 Mac App Store 的 The Best of 2013。它支持更多的写作格式、多文档的支持。Mou，iA writer 这些软件都是基于单文档的管理方式，而 Ulysses 支持 Folder、Filter 的管理，一个 Folder 里面可以创建多个 Sheet，Sheet 之间也可以进行 Combine 处理。
Ulysses Mou Byword write 'JD iA Writer Pro
Mac 上一些 Markdown 编辑器

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

![优 雅 的 Tumblr 客 户 端 —Tublme for Mac 优 雅 的 Tumblr 客 户 端 一 ！囗〔h卸刀 、 M3.sinaimg.cn/large/6aee7dbbgmefewdnhnaj20rfoczgn5jpg) Tublme for Mac > 从 “ 我 的 Fa ok 不 喜 欢 被 父 母 监 视 ” 到 “ 我 的 微 信 朋 友 圈 已 设 置 不 分 享 给 家 人 六 在 Faceb k 横 扫 全 球 的 现 在 ， 青 少 年 虽 然 仍 然 活 跃 在 Face ok ， 但 也 同 样 选 择 着 mnblr ， 对 于 他 们 来 讲 ， 代 表 新 时 代 的 文 艺 风 尚 ， 可 以 完 全 个 性 化 打 造 博 客 空 间 ， 挑 选 喜 欢 的 颜 色 、 设 计 ， 表 达 真 实 的 自 我 。 曾 经 在 Mac 上 苦 苦 寻 找 一 个 优 秀 的 Tumblr 客 户 端 ， 功 夫 不 负 有 心 人 ， 友 人 推 荐 了 这 款 功 能 比 较 爆 表 的 客 户 端 —tm)lmeforMac] The definitive Tumblr (https://itunes.apple.com/us/app/tublme-tumblr-on-your-desktop/id718420386? desktop client for Mac mt = 12 & 卜 mpt 艹 0 ％ 3D4 ） 。 价 格 也 十 分 公 道 ， 一 见 倾 心 。 { 入 昴 st 。 re # # # 上 手 ！囗 〔 http://、M2.sirmmg.cn/large/6aee7dbbgmefex2Y2ef5j20j60usdjtjpg) 从 “ 我 的 Face № ok 不 喜 欢 被 父 母 监 视 ” 到 “ 我 的 微 信 友 睏 巳 设 置 不 分 享 给 Tublme for Ma 的 浏 览 方 式 十 分 直 观 ， 传 统 的 T 皿 ehne 浏 览 方 式 ， 纯 黑 的 界 面 以 便 于 更 家 人 ” ， 在 Facebook 横 扫 全 球 的 现 在 ， 青 少 年 虽 然 仍 然 活 跃 在 Fa b k ， 加 沉 浸 在 每 一 个 行 文 字 ， 上 手 即 用 ， 配 合 Retina 显 示 效 果 下 有 着 极 佳 的 阅 读 感 受 。 主 界 面 上 的 功 能 简 洁 但 不 简 陋 ， 随 时 可 以 在 Dash ard 和 Activi 几 个 页 面 中 直 接 切 换 查 看 各 项 但 也 同 样 选 择 着 Tumblr ， 对 于 他 们 来 讲 ， Tumblr 代 表 新 时 代 的 文 艺 风 信 息 ， 如 果 你 有 多 个 帐 号 需 要 同 时 维 护 ， 账 户 切 换 在 主 界 面 上 可 谓 十 分 效 率 。 尚 ， 可 以 完 全 个 性 化 打 造 博 客 空 问 ， 挑 选 喜 欢 的 颜 色 、 设 计 ， 表 达 真 实 的 自 我 。 # # # 功 能 \](http://ww4sinamg.cn/1arge/6aee7dbbgw1efeyoa6znkj20usom2mz.3.jpg) 曾 经 在 Mac 上 苦 苦 寻 找 一 个 优 秀 的 Tumblr 客 户 端 ， 功 夫 不 负 有 心 人 ， 友 人 推 荐 作 为 一 款 轻 博 客 的 客 户 端 ， 分 享 发 布 功 能 当 然 是 最 核 心 也 是 重 中 之 重 的 功 能 ， 在 了 这 款 功 能 比 较 爆 表 的 Tumb \] r 客 户 端 —Tublme for Maco 价 格 也 十 分 公 道 ， 偏 好 设 置 里 ， 我 欣 慰 的 看 到 了 支 持 Markdown 这 种 轻 量 级 编 写 语 言 ， 关 于 Markdown 的 好 处 可 是 多 的 说 不 完 ， 单 从 这 个 功 能 来 讲 ， 这 款 app 实 在 是 令 人 欢 喜 。 如 果 日 后 加 入 见 倾 心 。
简书的编辑预览模式
二，Markdown 语法的简要规则
*标题
Untitled # 一 级 标 题 # 二 级 标 題 # # 三 级 标 题 # # # 些 级 标 题 # 五 级 标 题 # # # # 六 级 标 一 级 标 题 二 级 标 题 三 级 标 题
标题
标题是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定义为标题，只要在这段文字前加 # 号即可。

一级标题

二级标题

三级标题

以此类推，总共六级标题，建议在井号后加一个空格，这是最标准的 Markdown 语法。
列表
熟悉 HTML 的同学肯定知道有序列表与无序列表的区别，在 Markdown 下，列表的显示只需要在文字前加上 - 或 即可变为无序列表，有序列表则直接在文字前加1. 2. 3. 符号要和文字之间加上一个字符的空格。
Untitled # # # # 无 序 列 表 # # # # 有 序 列 表 ords 无 序 列 表 有 序 列 表
无序列表与有序列表
引用
如果你需要引用一小段别处的句子，那么就要用引用的格式。
例如这样
只需要在文本前加入 > 这种尖括号（大于号）即可
Untitled > 这 里 是 引 用 要 注 意 符 号 和 文 本 间 的 空 格 ords 这 里 是 引 用 要 注 意 符 号 和 文 本 间 的 空 格
引用
图片与链接
插入链接与插入图片的语法很像，区别在一个 !号
图片为：{ImgCap}{/ImgCap}
链接为：
插入图片的地址需要图床，这里推荐围脖图床修复计划 与 CloudApp 的服务，生成URL地址即可。
![Untitled Baidul (http://baidu.com) ! (Mou icon) (http://mouapp.com/ Mou_128. png )
URL 与图片
粗体与斜体
Markdown 的粗体和斜体也非常简单，用两个 包含一段文本就是粗体的语法，用一个 包含一段文本就是斜体的语法。
例如：这里是粗体 这里是斜体
*表格
表格是我觉得 Markdown 比较累人的地方，例子如下：

| Tables | Are | Cool | | —- | —- | —- |

| col 3 is | right-aligned | $1600 |

| col 2 is | centered | $12 |

| zebra stripes | are neat | $1 |

这种语法生成的表格如下：

|

| | | | —- | —- | —- |

| Tables | Are | Cool |

| col 3 is | right-aligned | $1600 |

| col 2 is | centered | $12 |

| zebra stripes | are neat | $1 |

代码框
如果你是个程序猿，需要在文章里优雅的引用代码框，在 Markdown下实现也非常简单，只需要用两个 ` 把中间的代码包裹起来。图例：
Untitled protected void Page_Load(object sender, EventArgs e)' tbxOutput. Text = string. Format OS: {1} Environment . NewLine , Environment . OSVersion Word protected void se tbxOutput Text string. Format Environment . NewLine Environmen
使用 tab 键即可缩进。
分割线
分割线的语法只需要三个 号，例如：
到这里，Markdown 的基本语法在日常的使用中基本就没什么大问题了，只要多加练习，配合好用的工具，写起东西来肯定会行云流水。更多的语法规则，其实 Mou 的 Help 文档栗子很好，当你第一次使用 Mou 时，就会显示该文档。可以用来对用的查找和学习。
![Untitled # Mou ! [Mou icon) (http://mouapp.com/Mou_128.png) # Overview the missing Markdown editor for web developers ### Syntax #### Strong and Emphasize —strong— ( Cmd + B ) emphasize or emphasize ( Cmd —Sometimes I want a lot of text +1) to be bold. Like, seriously, a LOT of text— #### Blockquotes Right angle brackets > #### Links and Email are used for block quotes. An email link. Simple inline tink <http://chenluois . corn>, [Smaller] (http : //smallerapp.com) , one more [Resize) (http://resizesafari.com “a Safari another inline link inline link with title extension” ) A [reference style] lid] link. Input id, then anywhere in the doc, define the link with corresponding id: lid]: http://mouapp. com “Markdown editor on Mac OS X” Titles ( or called toot tips ) in the links are optional. Images An inline image ! (Smaller icon] (http://smallerapp.com/favicon. ico “Title here”), title is optional. A ! [Resize icon] 2] reference style image. http://resizesafari. com/favicon.ico “Title” #### Inline code and Block code Mou Overview Mou, the missing Markdown editor for web developers. Syntax Strong and Emphasize strong or strong ( Cmd + B ) emphasize or emphasize ( Cmd + I ) Sometimes I want a lot of text to be bold. Like, seriously, a LOT of text Blockquotes Right angle brackets > are used for block quotes. Links and Email An email example@example.com link. Simple inline link http://chenluois.com, another inline link Smaller, one more inline link with title Resize. A reference style link. Input id, then anywhere in the doc, define the link with corresponding id: Titles ( or called tool tips ) in the links are optional. Images An inline image , title is optional.
三，相关推荐:
*工具
图床工具用来上传图片获取 URL 地址

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

相关文章阅读：

本文首发在少数派转载请注明原作者，如果你觉得这篇文章对你有帮助或启发，也可以来请我喝咖啡。
利益相关：本篇文章所有涉及到的软件均为笔者日常所用工具，无任何广告费用。
© 著作权归作者所有
已使用 Microsoft OneNote 2016 创建。