Markdown 简介
Markdown 编辑器推荐
- 在线版
  - 1. dillinger
  - 2. StackEdit
  - 3. MaHua
  - 4. 简书
  - 5. 马克飞象
- windows
  - 1. MarkdownPad
  - 2. MarkPad
  - 3. Smark
  - 4. Miu
- OSX
  - 1. Mou
  - 2. MacDown
  - 3. Ulysses
  - 4. iA Writer
  - 5. MWeb
- 跨平台
  - 1. Cmd Markdown
  - 2. 小书匠编辑器
  - 3. FarBox
  - 4. Sublime Text 2
  - 5. Atom
  - 6. ReText
- 注
Markdown 基本语法
- 段落
- 粗体、斜体
- 删除线
- 下划线
- 标题
- 引用
- 列表
- 内联代码
- 代码区域
- 分隔线
- 链接
- 图像[别忘了最前面有一个叹号偶！]
- 自动链接
- 转义
- 表格【带完善】
- 内联 HTML
Markdown 高级语法
- 自定义列表
- 目录
- TeX公式
- UML图
Markdown + Gitbook
- 使用Gitbook制作电子书
- 使用Gitbook发布电子书
- 注
Markdown + R
- 科技写作与Markdown+R
  - 科技写作会碰到什么难题？
- Markdown+R如何解决的？
- Rmd 简介
  - 安装并配置RStudio
  - 新建Rmd文档
- 这么做，有什么好处呢？
  - 真正意义上的可重复性研究
  - 更强大的数学与制图能力
  - 当然，还有云计算
- Markdown格式与LaTeX、Word等格式的互转
- 如何学习Markdown+R？
  - Markdown格式说明
  - Markdown编辑器
- Windows下的GitHub特别说明
- 如何学习R
  - Rstudio
  - R语言入门读物
- 示范
  - 文艺青年
  - 科学青年
  - 技术青年
Markdown + Pandoc

Markdown 简介

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。

Markdown具有一系列衍生版本，用于扩展Markdown的功能(如表格、脚注、内嵌HTML等等)，这些功能原初的Markdown尚不具备，它们能让Markdown转换成更多的格式，例如LaTeX，Docbook。Markdown增强版中比较有名的有Markdown Extra、MultiMarkdown、 Maruku等。这些衍生版本要么基于工具，如Pandoc；要么基于网站，如GitHub和Wikipedia，在语法上基本兼容，但在一些语法和渲染效果上有改动。

Markdown 编辑器推荐

在线版

1. dillinger

漂亮强大，支持md, html, pdf 文件导出。支持dropbox, onedrive，google drive, github. 来自国外，可能不够稳定。

2. StackEdit

输出美观大方，可本地保存，还有拼写检查，但是对中文支持不好，可以从截图中看到，中文全部被标记为拼写错误，而且源代码中汉字的字间距太大。

3. MaHua

小众软件推荐，界面有些简陋。

4. 简书

一个很不错的博客平台，每几秒钟便会自动存入一个备份。可以直接从本地拖入照片生成链接，一直在不断优化。作为一个博客平台，需要注册账号后方能进行写作。

5. 马克飞象

因为印象笔记不支持Markdown，而这款可以直接把文本存到印象笔记的编辑器对于重度印象笔记用户是个不错的选择。付费软件，可以免费试用。

windows

1. MarkdownPad

用户可以通过键盘快捷键和工具栏按钮来使用或者移除 Markdown 格式。MarkdownPad左右栏的分割方式令用户可以实时看到 HTML 格式的 Markdown 文档。

2. MarkPad

MarkPad 是款开源的 Markdown 编辑器，与 Window 8 风格和谐友好的界面，可以直接在你的博客或者 GitHub 中打开、保存文档，直接将图片粘贴到 Markdown 文档中。

3. Smark

开源软件。

4. Miu

一款模仿mou 的windows平台markdown编辑器，小众推荐，必属精品，官网无法打开，好在小众提供了百度云下载。界面美观，功能不够成熟

OSX

1. Mou

Mou 是 Mac下杰出的 Markdown 编辑器，提供语法高亮、在线预览、同步滚动、全屏模式，支持自定保存、自动匹配，允许自定义主题，支持 CSS，HTML 和 PDF 导出等。

2. MacDown

开源且免费。

3. Ulysses

支持OS X , iPad，售价 283元。堪称markdown编辑器中的佼佼者。

4. iA Writer

支持OS X , iOS 及Android，未优化中文显示，售价68，pro版本128元。

5. MWeb

专业的 Markdown 编辑器。UI漂亮，主题可选。支持markdown扩展语法，支持打字机滚动模式，支持发布到wp、blogger、tumblr等多个博客。

跨平台

1. Cmd Markdown

作业部落出品，也是一款不错的工具和博客平台兼顾的产品。全平台且提供web版。

2. 小书匠编辑器

全平台覆盖并且有web版。

3. FarBox

一个支持Markdown写作语法的博客平台，让用户通过Dropbox(现在默认是自己的同步服务器)直接建立个人网站。FarBox编辑器免费，支持多平台(无web版，Linux版停止维护)，个人认为是Windows平台最优雅的编辑器。多说一句，Farbox服务可以免费试用，在本地编辑器内写作自动同步发布在个人博客，对像笔者这样希望有个人博客但却不愿折腾的小白来说，是个不错的选择。

4. Sublime Text 2

界面简约大方，定位专业。价格70美元，但是如果你能忍受时不时弹出的注册提醒，完全可以免费使用。唯一美中不足的是markdown并非其原生功能，需要安装插件。

5. Atom

github出的编辑器，功能十分强大，除了编写代码之外还可以做为markdown编辑器，并且原生支持markdown预览，按ctrl+shift+m弹出。

6. ReText

用python开发的，所以跨平台。ReText 是一个使用 Markdown 语法和 reStructuredText (reST) 结构的文本编辑器，编辑的内容支持导出到 PDF、ODT 和 HTML 以及纯文本，支持即时预览、网页生成以及 HTML 语法高亮、全屏模式，可导出文件到 Google Docs 等。

注

部分内容来自月光博客 - 好用的Markdown编辑器一览。

Markdown 基本语法

段落

非常自然，一行文字就是一个段落。段落我一般是不会用到的！如果要使用段落的话那么就是用HTML的p标签！

<p>这是一个段落。</p>

如果你需要另起一段，请在两个段落之间隔一个空行。【就是按下你键盘上面的回车键！enter】【或者使用HTML中的
标签！】

粗体、斜体

可以使用星号*或下划线_指定粗体或者斜体。【你也可以使用组合键ctrl + b】【同样是可以使用原生的HTML标签！】

*这是斜体*
_这也是斜体_
**这是粗体**
***这是粗体+斜体***

lvhanghmm

lvhanghmm

会被解释成

<em>这是斜体</em>
<em>这也是斜体</em>
<strong>这是粗体</strong>
<strong><em>这是粗体+斜体</strong></em>

删除线

一部分编辑器支持删除线，它不是经典markdown中的要素。用波浪线~定义删除线。

~~就像这样~~

~~lvhanghmm~~

ascdxckn

<strike>就像这样</strike>

下划线

直接使用原生HTML标签u就可以实现了！

<u></u>

lvhanghmm

标题

markdown总支持1~6六级标题，通过在一行之前加上不同数量的井号来表示。【当然，你也可以使用快捷键ctrl + 1~6(我一般就是这样用的！)】

# 这是 H1 ### 这是 H2 ##### 这是 H3 ###...###### 这是 H6 ######

行尾可以加上任意数量的井号字符，这些字符不会算作标题内容。通常会加上相等数量的字符以保持对称。

引用

通过在行首加上大于号>来添加引用格式。【也可以使用快捷键ctrl + shift + Q】

> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

引用可以嵌套：

> This is the first level of quoting.>> > This is nested blockquote.>> Back to the first level.

也可以嵌套其他格式：

> ## 这是一个标题。>> 1.   这是第一行列表项。> 2.   这是第二行列表项。>> 给出一些例子代码：>>     return shell_exec("echo $input | $markdown_script");

列表

无序列表使用星号* 、加号 + 或是减号 - 作为列表标记：【同样，也可以使用原生的HTML标签来实现！】

等同于

*   Red+   Green—   Blue

有序列表则使用数字接着一个英文句点：

1.  Bird2.  McHale3.  Parish

内联代码

用反引号```来标记内联代码，它们会解释成<code>标签。如果代码的内容中有反引号，请用两个反引号包裹。代码中的&、<、>符号都会自动转义，请放心使用。

代码区域

你可以在首行用英文状态下的三个顿号加上你要显示语言的后缀！就可以了！栗子：

````js`

第二种就是用原生HTML代码

[不推荐！]

分隔线

你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

*************************---------------------________________________

链接

如果括号里的是图片的地址，中括号里什么也不填，那么就会显示这张图片！栗子：

[an example](http://example.com/)[an example](http://example.com/ "Optional Title")

除了上面的行内式，也可以使用参考式：

[an example][id]

[][https://img2020.cnblogs.com/blog/2031306/202105/2031306-20210519165809768-1659520618.png]

[id][https://img2020.cnblogs.com/blog/2031306/202105/2031306-20210519165809768-1659520618.png]

然后在任意空白位置定义：

[id]: http://example.com/ "Optional Title"

图像[别忘了最前面有一个叹号偶！]

![Alt text](/path/to/img.jpg)![Alt text](/path/to/img.jpg "Optional Title")

会被解释为

<img src='/path/to/img.jpg' alt='Alt text' /><img src='/path/to/img.jpg' alt='Alt text' title='Optional Title' />

同样，图像也有类似的参考式语法。【当然，你也可以直接用原生的HTML】

自动链接

如果链接的地址和名字重复，可以用尖括号语法将其简化。

<http://example.com/>

就相当于

[http://example.com/](http://example.com/)

切记，大多数编辑器都会自动将符合url规则的东西视为链接，并且解释成链接。很多时候作者由于疏忽等缘故，链接和后面的中文之间缺少空格，导致链接不正常。所以我建议，链接要么加上尖括号，要么两端加上空格。

转义

markdown支持在以下字符前面插入反斜杠

\   反斜线`   反引号*   星号_   底线{}  花括号[]  方括号()  括弧#   井字号+   加号-   减号.   英文句点!   惊叹号

插入之后，将不再解析这些字符，而是原样输出。

表格【带完善】

| Item     | Value | Qty   || :------- | ----: | :---: || Computer | $1600 |  5    || Phone    | $12   |  12   || Pipe     | $1    |  234  |

会被解释成

<table><thead><tr>  <th align="left">Item</th>  <th align="right">Value</th>  <th align="center">Qty</th></tr></thead><tbody><tr>  <td align="left">Computer</td>  <td align="right">$1600</td>  <td align="center">5</td></tr><tr>  <td align="left">Phone</td>  <td align="right">$12</td>  <td align="center">12</td></tr><tr>  <td align="left">Pipe</td>  <td align="right">$1</td>  <td align="center">234</td></tr></tbody></table>

要注意第二行的冒号决定了居左居右还是居中，如果你不加冒号，默认是居左的。

另外可以把第一行去掉，做成没有表头的表格，但第二行始终是要有的。

内联 HTML

markdown 的语法简洁，但有其局限性，所以特意保留了内联html这种方式。任何html标签及其内容，都会原样输出到结果中。也就是说，标签中的星号等作为markdown结构的符号，以及构成html标签和实体的符号，都不会做任何转义。

Markdown 高级语法

只有少数编辑器支持，使用前请先确认。

自定义列表

Term 1Term 2:   Definition A:   Definition B

会被编译成

<dl><dd>Term 1</dd><dd>Term 2</dd><dt>Definition A<dt><dt>Definition A<dt></dl>

Markdown 简介
Markdown 编辑器推荐
- 在线版
  - 1. dillinger
  - 2. StackEdit
  - 3. MaHua
  - 4. 简书
  - 5. 马克飞象
- windows
  - 1. MarkdownPad
  - 2. MarkPad
  - 3. Smark
  - 4. Miu
- OSX
  - 1. Mou
  - 2. MacDown
  - 3. Ulysses
  - 4. iA Writer
  - 5. MWeb
- 跨平台
  - 1. Cmd Markdown
  - 2. 小书匠编辑器
  - 3. FarBox
  - 4. Sublime Text 2
  - 5. Atom
  - 6. ReText
- 注
Markdown 基本语法
- 段落
- 粗体、斜体
- 删除线
- 下划线
- 标题
- 引用
- 列表
- 内联代码
- 代码区域
- 分隔线
- 链接
- 图像[别忘了最前面有一个叹号偶！]
- 自动链接
- 转义
- 表格【带完善】
- 内联 HTML
Markdown 高级语法
- 自定义列表
- 目录
- TeX公式
- UML图
Markdown + Gitbook
- 使用Gitbook制作电子书
- 使用Gitbook发布电子书
- 注
Markdown + R
- 科技写作与Markdown+R
  - 科技写作会碰到什么难题？
- Markdown+R如何解决的？
- Rmd 简介
  - 安装并配置RStudio
  - 新建Rmd文档
- 这么做，有什么好处呢？
  - 真正意义上的可重复性研究
  - 更强大的数学与制图能力
  - 当然，还有云计算
- Markdown格式与LaTeX、Word等格式的互转
- 如何学习Markdown+R？
  - Markdown格式说明
  - Markdown编辑器
- Windows下的GitHub特别说明
- 如何学习R
  - Rstudio
  - R语言入门读物
- 示范
  - 文艺青年
  - 科学青年
  - 技术青年
Markdown + Pandoc

TeX公式

内联的TeX公式使用一个美元符号标记。

$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

会被编译成

TeX公式块用独占一行的两个美元符号来标记。

$$\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.$$

会被编译成

如果你的编辑器不支持这个功能，可以手动解决。首先引入mathjax脚本：

<script type="text/javascript" src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML"></script>

之后，在需要插入公式的地方使用<script>标签包裹公式：

<script type="math/tex">\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N</script><script type="math/tex; mode=display">\Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,.</script>

TeX的语法参考请见这里。

UML图

可以像这样来画uml时序图：

这是uml流程图：

时序图的语法请见这里。流程图的语法请见这里。

Markdown + Gitbook

使用Gitbook制作电子书

Gitbook是一个命令行工具，可以把你的Markdown文件汇集成电子书，并提供PDF等多种格式输出。你可以把Gitbook生成的HTML发布出来，就形成了一个简单的静态网站。Gitbook还有一个同名的平台(gitbook.io)，可以发布和销售电子书，并提供了一个Markdown客户端工具(支持Mac、Windows和Linux)帮助写作。以下是我在使用Gitbook中的笔记。

首先Gitbook和Git/Github都没有什么关系。它只是一个build book的工具而已。但它的Git前缀的确引起了许多人的迷惑，起初我认为至少它也是个和Github类似的Git平台吧，但其实没什么关系，你只要懂几条markdown语法，不必理解任何与Git相关的东西就能用Gitbook了，不要为其名字迷惑。

第0步 安装npm(Node Package Manager)。从node.js的官网上下载安装程序，即可完成Node.js和npm的安装。

第1步 通过npm安装Gitbook。

$ npm install gitbook -g

完成后花10分钟阅读下Gitbook的帮助文档。如果你没耐心看手册，那就继续往下读吧 😄

第2步 了解Gitbook的基本规则。

Gitbook需要2个基本文件：

README.md
SUMMARY.md

README.md是关于你的书的介绍，而SUMMARY.md中则包含了书目，即章节结构，它的格式大致是：

*  [第1章](c1.md)    *  [第1节](c1s1.md)    *  [第2节](c1s2.md)  *  [第2章](c2.md)

剩下的东西就很好理解了，你只需要编写相应章节即可。在编辑完README.md和SUMMARY.md后，你可以运行以下命令：

$ gitbook serve -p 8080 .

Gitbook首先把你的Markdown文件编译为HTML文件，并根据SUMMARY.md生成书的目录。所有生存的文件都保存在当前目录下的一个名为_book的子目录中。完成这些工作后，Gitbook会作为一个HTTP Server运行，并在8080端口监听HTTP请求。

运行以上命令后，打开浏览器，在地址栏输入：http://localhost:8080即可看到你的书页了。

其中位于左侧书目顶部的Introduction一节就编译自README.md，而书目本身自编译自SUMMARY.md。你要在自己的网站上发布新书，只需把_book目录复制到服务器相应目录即可。至此Gitbook的基本用法就介绍完毕。下面简单讨论下Gitbook的其他应用，包括Gitbook的插件、与Github的融合、Gitbook客户端、Gitbook平台，以及Gitbook的问题。

Gitbook的插件支持

Gitbook可以生成HTML，因此它支持一些外部的JavaScript文件嵌入到HTML中，例如Google统计、Disqus评论系统等。以下以页面中嵌入Disqus评论为例。

首先是安装Gitbook的Disqus插件。

$ npm install gitbook-plugin-disqus

然后建立一个book.json文件，其格式如下：

{  "plugins":  ["disqus"],  "pluginsConfig":  {  "disqus":  {  "shortName":  "NAME-FROM-DISQUS"  }  }  }

把上面的NAME-FROM-DISQUS修改为你在Disqus上的项目名即可。

再次运行命令：

$ gitbook serve -p 8080 .

并刷新浏览器，即可看到附加了Disqus评论的页面。

与Github的融合

Gitbook的博客上说Github提供了对Gitbook的特殊支持，但我没有测试。只是依然把源文件保存在Github上，然后用Gitbook去编译。期待Gitbook做的更好。

Gitbook客户端

Gitbook客户端支持Mac、Windows、Linux。我在Mac和Windows简单尝试了这个客户端，总体而言可以用。但也仅仅是可以用而已。你可以在客户端里编辑Markdown文件，并提供一个实时的预览窗口；可以关联到你的Gitbook账户，并把内容同步到gitbook.io，并为你生成PDF等。说句题外话，如果你要Markdown的客户端的话，飞象马克更好用，至少Vim编辑模式你得支持啊。

Gitbook的问题

Gitbook网站的访问速度很慢。可以在生成_book目录后，把其中的HTML文件和gitbook子目录(包含字体和js文件等)复制到自己的网站上。

Gitbook提供的push功能不能用。push.gitbook.io这个地址无法访问，不知是否是临时性服务故障。

Gitbook生成PDF的中文字体极其难看。万分期待改进。话说Gitbook生存的HTML上的中文非常漂亮。

在我的手机上看Gitbook的页面时，会让浏览器挂掉。

使用Gitbook发布电子书

上次说到用GitBook制作电子书，侧重在使用gitbook这个命令行工具，今天要说的重点是GitBook这个平台。当你把书放到GitBook上后，可以设置书的价格(每笔交易GitBook抽走20%作为佣金)，也可以设置为免费，以及接受捐赠。如果你要收费或接受捐赠，则需要一个PayPal账户。在开始前，我要友情提示一句，在国内访问GitBook的速度很慢，通过VPN访问才好。

第-1步 用git这个源代码管理工具来管理你的Markdown文件。最好有个GitHub账户，这样每次push到GitHub时，GitBook都会自动为你的更新build新的版本(同时生成HTML、PDF、ePUB、MOBI这4个版本)。

第0步 注册一个GitBook帐号。

第1步 在GitBook添加一本书，填写书名等基本信息即可。完成后，GitBook会为你生成一个git仓库，其格式为：

https://push.gitbook.io/{author}/{book}.git

author即你的GitBook用户名，book即你的书名，如我创建的书的git仓库：

https://push.gitbook.io/berlinix/guaidanuniversity.git

这样你可以在编写完Markdown后，通过git push同步到GitBook。

第2步 把你本地的Markdown文件push到GitBook。我发现git push时常失败(服务器返回5xx错误)，因此还有一种方法就是把你的GitHub项目与GitBook关联。每次push到GitHub时，会通过GitBook的webhook自动同步到GitBook上。

在Book Setting中简单配置一下即可，如我的配置为：berlinix/gdu (GitHub用户名为berlinix，GitHub仓库名为gdu)

在第一次push后，就可以看到你在GitBook上的电子书了，其访问地址为：

http://{author}.gitbooks.io/{book}/

这是你电子书的主页，从这个页面可以直接打开HTML版本，或下载PDF等电子书版本，一般用户也可以为你的书添加评论。如：

http://berlinix.gitbooks.io/guaidanuniversity/

要直接访问HTML版本，可以通过链接：

https://www.gitbook.io/read/book/{author}/{book}

直接访问，如：

https://www.gitbook.io/read/book/berlinix/guaidanuniversity

至此，GitBook平台的基本用法就介绍完毕。下面是我的一些使用经验。

个性化域名

HTML版本的URL很复杂，可以使用个性化域名简化之。在域名注册商那里添加一条CNAME记录即可，如：

CNAME gdu.berlinix.com www.gitbook.io 300

并把gdu.berlinix.com配置到Book Setting中去，这样可以通过简单的gdu.berlinix.com来取代https://www.gitbook.io/read/book/berlinix/guaidanuniversity。同理，电子书的主页也可设置个性化域名，就不再赘述。

删除电子书

同样是在Book Setting中，可以删除电子书。在电子书列表中没有删除接口。

GitBook电子书封面

可以为电子书添加封面。只需添加2个名为cover.jpg和cover_small.jpg的两个图片即可。官方建议cover.jpg尺寸18002360，cover_small.jpg尺寸200262。花2元即可在淘宝上找个做封面的人为你制造一个简单的封面，做得好就要花更多一些了 😃

GitBook帐号头像

似乎只接受Gravatar.com的头像。把Gravatar帐号关联过去即可。Gravatar提供的服务是把你的邮箱和头像关联起来，当你在其他网站注册时就不用每次都上传同一个头像，只需简单与Gravatar帐号关联即可。这样替换头像也方便了，一次替换、处处生效。

访问优化

按GitBook的访问速度，如果真让人访问GitBook上的HTML页面真是自寻死路啊，因此最好是把GitBook编译后的HTML放在自己的网站上。同时，为自己网站的HTML生成Disqus支持。例如你可以访问我放到自己服务器后的页面(用手机访问效果也非常好)：

http://www.berlinix.com/gdu/index.html

电子书Bug

上次说到GitBook生成PDF的中文字体非常丑陋，另外还有一个问题，那就是生成的PDF可能是残全不全的。我编译后发现内容只剩一半。我已邮件过去报告这个Bug，还在等回信 😃

总体而言，GitBook还是很好玩，比起其他写作平台而言，要自由、简单，并舒服得多，可以用Vim编辑，支持Markdown语法，用git管理，关联GitHub后每次push后还能自动编译，生成多种电子书格式。如果你的书极为畅销的话，还能获取到捐赠或购买，没有理由不尝试的呀。

注

来源：

使用Gitbook制作电子书
使用GitBook平台发布电子书

Markdown + R

来源：Markdown写作浅谈

科技写作与Markdown+R

科技写作会碰到什么难题？

如果你是纯文科生，写的都是豆瓣小酸文或者诗歌之类的，那么，看完上面这一部分就可以打住了。如果你还有写科技论文的需要，则继续往下看。

科技写作与文艺写作的不同主要有：

公式与图表：相信各位写过科学论文的，都会为数学公式与各类图表的输出头疼不已；
格式转换：pdf是通用的，但是有时偏偏需要LaTeX原始格式或者Word原始格式；
参考文献：投稿给不同刊物，往往参考文献要根据对方的格式来调整。

解决这些难题，LaTeX是国际科学界，尤其是偏数理类的学科的主流方案之一。当然，因为中国盗版office的流行，导致国内科技论文Word更盛行，则是另一码事。Word因为近些年在参考文献协作软件、数学公式方面的发力，也逐步成为科技界认同的论文投递标准之一。

提到LaTeX的人们，常常有两种口气。一种是当做大神来敬仰的，当语言、软件变为传奇，路人皆知它的诞生历史时，于是，众多如你我这类文科生，只有抬头仰望的份了。另一类，则是不屑的口气，LaTeX那么好学，你怎么都学不会！国际期刊都是用这个写的，你别混了。。。

于是，我等文科生只好在被鄙视的眼光之下，快快走过LaTeX。。。但是，LaTeX真的符合人们写作习惯吗？请记住当时的历史。那时的计算机，所见即所得，并不像今天这么流行。那时的计算机，处理能力也不像今天这么强大。更别提什么脚本语言了。翻出上一份LaTeX文档所用的APA模版，大家就知道它有多么坑爹了。。。

使用Lyx，好看多了。问题是，它有坑吗？你跳过吗？

Markdown+R如何解决的？

每位试图解决LaTeX的不便，又试图保留它的优点的人们，都走上了一条不归路。

直到有一天，极其熟悉LaTeX，也熟悉Markdown的yihui同学，意识到了，LaTeX它可以作为最终格式生成。但是，我们中间的写作过程，完全可以用Markdown这么简单明了的语法来写，我们真正需要的，就是一堆数学公式、图表与参考文献而已。前2者，恰恰是R的强项。后者，则留给开源社区，下一步解决。(可参考线索1、线索2、线索 3 )

于是，在他的新作R包knitr中，果断提供了Markdown支持。并说服R社区主流编辑器厂家，开源软件RStudio 提供 Markdown支持，从而使得Rmd这种新格式开始流行。我们有幸看到这个重要格式的诞生，国人的贡献如此重要。

Rmd 简介

Rmd 格式更详细的描述，读 yihui 的文档：自动化报告

在这里，让我简单说明，如何最快上手Rmd格式。

安装并配置RStudio

下载 RStudio 之后，打开配置选项，如下图所示：

然后，进行如下配置：

新建Rmd文档

新建一个Rmd文档，如下图所示：

然后，默认会出来一些内容。如果你对Markdown语法有不熟悉的地方，点击MD按钮。写完之后，直接点击： Knit HTML 按钮即可发布。MD按钮与Knit Html按钮的位置如下图所示：

就会预览成功。你也可以点击保存，生成相应的图片、Markdown文档。

是的，你要的一切图片都有了！这就是 yihui 所推崇的文学性编程、可重复研究概念的神奇。

更重要的是，还保留了对LaTeX的无缝兼容。比如，大家可以敲下这段文字：

其中，这一段，

$$latexf(x;\mu,\sigma^2) = \frac{1}{\sigma\sqrt{2\pi}} e^{ -\frac{1}{2}\left(\frac{x-\mu}{\sigma}\right)^2 }$$

就是直接生成LaTeX格式的数学公式！

没有安装RStudio，或者不熟悉R的朋友，可以在我搭建的一个在线演示APP里面，将上述代码，粘贴上去，然后看看神奇的效果！

网址是：R Markdown App 效果如下图所示：

这么做，有什么好处呢？

让我细数一下：

真正意义上的可重复性研究

发表论文或者审核同事的报告，有个最麻烦的事情，你不知道他的步骤或者计算是否有误。现在，代码嵌在报告正文中，或者附录在报告末尾。而你，要做的，仅仅是一键生成。。。这就是真正意义上的可重复性研究！

更强大的数学与制图能力

既兼容了LaTeX的既有能力，同时，又广泛借助于R自身强大的作图与统计学习能力。

更重要的是，未来，并不是非要用R语言作图。yihui 同学在前文中的描述已经极其清楚了。

当然，还有云计算

真正意义上的云计算，尤其是类似于我们这样，中小企业、小型实验室实战使用的小型云计算，不同于各类忽悠的云计算。Markdown+R这种方式是最佳方式之一。上述例子中提到的那个APP，就是搭建在云中。同时提供各类REST接口，可以被Ruby程序调用。

Markdown格式与LaTeX、Word等格式的互转

点这里：Pandoc

还有不少有趣的玩法，如Building a beamer presentation with knitr.

如何学习Markdown+R？

好了，回到大家最关心的部分。分成两部分，先是如何学习Markdown，其次是如何学习R。

Markdown格式说明

参考：Markdown
更好的学习办法是直接读各类范本文件
更多资源参考V2ex节点

Markdown编辑器

Mac等平台下推荐Mou
Windows平台推荐MarkdownPad RStudio可作为写作科技论文与R语言编辑器选择，它是跨平台的
markdown-here借助Chrome插件，将gmai写作窗口变为Markdown在线写作窗口
可以直接在线通过github撰写与提交Markdown文件，github有自动的版本跟踪功能，不用担心写废与找不到以前写的

Windows下的GitHub特别说明

如果碰到git、github等与windows不兼容的现象，不建议折腾，而是直接在线提交即可。
GitHub最近发行了Windows版本，下载地址在这里
我的老文：如何高效利用github

如何学习R

Rstudio

Getting_Started_with_RStudio.pdf

R语言入门读物

R for SAS and SPSS Users.pdf ：适合有SPSS基础的朋友
Analysis of Questionnaire Data with R ：适合处理问卷数据的文科生或社会科学类
更多参考我的豆列：技术派心理学

示范

文艺青年

文艺青年看这里，

為什麼文科生也該用markdown寫作?
为什么作家应该用 Markdown 保存自己的文稿

科学青年

可以看这里：如何学习科学：开放科学工具箱

点击 RAW 即可看到原始格式。这是一个长文档的示范。另一个示范是作者写的一个在线DEMO：

云中的社会网络分析+Markdown

以及：Markdown+R科技文写作

技术青年

knitr以及各类Google、维基百科。
特别是：pandoc-markdown
Primarily Pandoc: Writing in Markdown instead of LaTeX

Markdown + Pandoc

来源：Markdown+Pandoc，打通写作界的任督二脉！

Markdown+Pandoc，可以把自己的写作内容，变成世界上已有的任何格式的文件，包括很炫的slide，html5。没有人(或者我没看到)总结过这些内容，导致我走了很多弯路才最终打通任督二脉，特此纪念。

了解Markdwon以后，我的写作世界，只有它；看到Pandoc格式转换以后，对生成的slide和pdf羡慕的不行。那时，自己期望以后的写作是这样的：首先用Markdown把自己的想法写下来；其次，通过Pandoc，把写好的Markdown文件，转换成Slide或者PDF。如此而已。

Pandoc，这个不知道怎么发音，google也没找到。好吧，我就读做panda吧，谁让它是国宝。

Pandoc的运行，是在命令行里面。可是，没那么简单，不是任何一个cmd都可以。你必须要下载Pandoc，请参考这里。根据自己的os，选择Windows 或者其他。

安装以后，记得Pandoc的目录是啥，然后再到cmd里面去操作一些失传已久的doc命令，转换到pandoc的路径下。

我个人习惯，是把要转换的文件，比如test.md，放到pandoc的路径下，这样在使用pandoc转换的时候，不用输入太多的路径(尤其是我们很多路径是中文，怕可能有一些问题)。当然，也可以调用其他路径的文件，只要自己觉得舒服。

pandoc，就像linux下的iconv，可以把其他格式的文件，转化成自己想要的格式。具体的格式参考请看这里。

个人常用的有两个格式转换：

a：md文件转换成html5

pandoc -s --mathml -i -t dzslides test.md -o test.html

b：md文件转换成pdf
```
pandoc -t beamer test.md -o test.pdf
```

这里强调一点，如果想转成PDF文件，要安装LATEX。推荐安装MiKTex。但是，中文转PDF，因latex支持中文差，转换有问题。对于Latex熟悉的人，可以参考这个，看是否能解决中文转slide pdf的问题。

文件转换完成以后，如果有一些地方不合适，可以调整原始的md文件，再转换一次。等熟练以后，从写，到转换就非常迅速了。当然，Pandoc还有很多的转换格式，大家可以自己去研究发觉。

关于Pandoc的使用，我没有过多的去研究。只是把自己常用的几个功能熟悉了一下。时间，真的真的很宝贵，不知不觉就从指缝中溜走了。所以，我只能在满足自己需求情况下，去使用pandoc。

期待大家更多的分享！

markdown基本语法 【未修改完成！】

Markdown 简介

Markdown 编辑器推荐

在线版

1. dillinger

2. StackEdit

3. MaHua

4. 简书

5. 马克飞象

windows

1. MarkdownPad

2. MarkPad

3. Smark

4. Miu

OSX

1. Mou

2. MacDown

3. Ulysses

4. iA Writer

5. MWeb

跨平台

1. Cmd Markdown

2. 小书匠编辑器

3. FarBox

4. Sublime Text 2

5. Atom

6. ReText

注

Markdown 基本语法

段落

粗体、斜体

删除线

下划线

标题

引用

列表

内联代码

代码区域

分隔线

链接

图像[别忘了最前面有一个叹号偶！]

自动链接

转义

表格【带完善】

内联 HTML

Markdown 高级语法

自定义列表

目录

TeX公式

UML图

Markdown + Gitbook

使用Gitbook制作电子书

使用Gitbook发布电子书

注

Markdown + R

科技写作与Markdown+R

科技写作会碰到什么难题？

Markdown+R如何解决的？

Rmd 简介

安装并配置RStudio

新建Rmd文档

这么做，有什么好处呢？

真正意义上的可重复性研究

更强大的数学与制图能力

当然，还有云计算

Markdown格式与LaTeX、Word等格式的互转

如何学习Markdown+R？

Markdown格式说明

Markdown编辑器

Windows下的GitHub特别说明

如何学习R

Rstudio

R语言入门读物

示范

文艺青年

科学青年

技术青年

Markdown + Pandoc

相关文章

markdown基本语法【未修改完成！】