转载

Markdown 简明指南

Markdown is a lightweight markup language with plain text formatting syntax designed so that it can be converted to HTML and many other formats using a tool by the same name.

Markdown 是一种 轻量级标记语言 ，使用简单的标记语法；它可通过使用工具（如同名Markdown工具）转换成具备格式展现的HTML或其他格式的文档形式。简称 MD ，本身可保存为 .md 格式。

Markdown 规定了一系列文本的书写格式。如本篇博文的源文件就是markdown编写的，左边就是MD文本，右边为HTML展示。

Markdown 简明指南

Why

Markdown 用简洁的语法代替排版，无须大型文字编辑软件，如 Word 或 Pages 。
Markdown 使我们专心于码字，用「标记」语法，来代替常见的排版格式。Markdown为纯文本，不存在软件兼容问题，可轻松的导出为HTML及PDF格式。
Markdown 源文本可读性强且学习成本低。Markdown 语法在程序猿中很流行，著名程序猿社区如 Github 和 Stack Overflow 都提供了对它的大量支持。

以上都是Markdown 的优点，但你是否真的需要？

我的观点是 Markdown 只是工具，主要是用来提升记录的效率。所以首先需要了解想以什么形式记录什么，该记录形式是否简单（如复杂的流程图及表格，MD实现起来并不简单也不推荐）；其实，使用MD是为了提高效率或体验的，如果早已习惯于其他书写文档的工具，也没必要为了跟风使用MD。

就我个人而言，使用MD无非就是记记笔记、写写博客；快捷舒适，不用在意格式（尤其是代码段的显示）。作为程序猿（媛），可以Geek点，使用Markdown吧~ ヽ(•̀ω•́ )

How

下面简要介绍几个MD常用语法（使用MD编辑工具，甚至可以不记任何语法）；更多语法可参考 Markdown 语法说明 (简体中文版)

使用一个或多个空行分隔内容段来生成段落（html中的 <p> ）
P.S. MD语法规范是空格+空格+回车换行，MD源文件中直接回车并不处理为换行
使用两个*包含一段文本格式即为粗体，用一个*包含一段文本即为斜体
如：MD文本： **我是粗体**，*我是斜体* 显示为 我是粗体 ， 我是斜体

使用相应个数的“#”作前缀作为标题（html中的 <h1> ~ <h6> ）
使用 > + 空格做前缀表示引用格式
使用 - 或 + 或 * 来表示无序列表；使用数字加 . 表示有序列表（html中的 <ul> 及 <ol> ）
使用 [link text](link url “optional link title”) 来标记普通链接（html中的 <link> ）
使用 ![img alt](img url “optional img title”) 来标记图片（html中的 <img> ）
P.S 引号内的 title 文字可选填，链接可使用相对路径