Rstudio MarkDown使用教程

认识MarkDown

MarkDown是一种轻量级的【标记语言】，它的优点很多，目前也被越来越多的写作爱好者，撰稿者广泛使用。，Markdown 的语法十分简单。常用的标记符号也不超过十个，对于大学里掌握了多门语言的我们来说，这种不需要思维，仅仅是对需要不同格式的文本前添加一些符号，简直是小case好吗？学习成本也不需要太多，且一旦熟悉这种语法规则，会有一劳永逸的效果。

（这是我自己独立完成的第一篇MarkDown，高兴的不得了）

点击查看MarkDown中文版说明

今天要介绍的内容，就是Rstudio 中对RMarkDown功能的应用。说白了，MarkDown不过是安装在R内的一个小功能，本周数据可视化课程，由王志刚老师引入，我也对这个编辑器和相关语法产生了浓厚的兴趣。经过两天的学习，自己也迷上了这种编译方法，清爽的页面显示，感觉整个文章都高大上了起来，对于word，wps之外的世界，这是我第一次这么喜欢一款网页文本编辑器。

一、准备工作

-安装R

-安装Rstudio（请确保你的版本越新越好，这个和IPHONE不一样，不存在升级版本变砖的情况）

-想查看版本号请使用>version命令

-按照下面图示做好你的前期准备工作

从这里开始，我们就可以运行Rstudio里的MarkDown了

由于Rstudio的基础安装包在首次解压安装时不自带rmarkdown的packages，所以我们需要根据提示完成下载工作。（rmarkdown类似于ggplot2的packages，需要去相关的CRAN下载，这一步需要联网

）

其中，黄色部分是提示你现在缺少的包你可以选择“Yes”在线安装，也可以在”Console”中键入install.packages( “包名” )命令安装
例如这里需要安装黄色标记的包,，就类似于学习R第一课里的下载、安装包的过程，代码如下（以图片缺少内容为例）：

install.packages( c(“htmltools”,”caTools”,”bitops”,”rmarkdown”) )

准备工作的操作图片参考了 ^-馒头-^ 的博客园
这里表示感谢

二、错误排查

如果你已经完成了上面的步骤，那么我们不可避免的会遇到一些错误，结合网络上大大们的铺垫，集中反馈的多为以下几类问题：

1.第一次点选Knit PDF（或Knit HTML)报错

Knit PDF : pandoc document conversion failed with error 43

可以通过安装 github 上最新的版本解决：

install.packages(“devtools”)

如果以前没有安装 devtools 包

devtools::install_github(“rstudio/rmarkdown”)

2.文档中出现中文（尤其是PDF格式下）

这个在很多的MarkDown介绍中都明确表示了不建议在PDF文档中使用中文，但在博主自己的尝试和简书·Yusheng的RStudio 中的 R Markdown介绍下，基本解决了这个问题。

! Package inputenc Error: Unicode char \u8:年 not set up for use with LaTeX.
Try running pandoc with –latex-engine=xelatex.

可以看到，明显提示中出现了ERROR的报错。我们尝试以下两种方法~

（1）LaTex 引擎改为 xelatex

操作步骤如图

（2）MarkDown编辑框中，在文档头信息中加入以下代码

output:
pdf_document:
latex_engine: xelatex

以上两步其实原理是一样的，只是菜单栏设置和代码编辑的区别，大家根据个人习惯自己选择。完成后就可以正常输出为 PDF 文档了，但是会发现所有的中文全部都是空白，这个主要是 LaTex 的配置问题，中文需要中文字体来渲染，可以通过在文件头中引入 LaTex 文件进行配置。

outputs:
pdf_document:
includes:
in_header: header.tex
latex_engine: xelatex

其中 header.tex 可以是：

\usepackage{xeCJK}
\setCJKmainfont{楷体} % 字体可以更换
\setmainfont{Georgia} % 設定英文字型
\setromanfont{Georgia} % 字型
\setmonofont{Courier New}

更多详细配置可以参考官方文档

三、语法规范

安装并调试完成后，就可以开始用markdown写上一行行漂亮的代码了