R Markdown 从安装到导出：一份完整的新手入门指南

关注

原创最新推荐文章于 2026-09-22 12:41:26 发布 278 阅读 AI 写同款· GEO 优化 ›

R Markdown_Rstudio中直接写文档且可导出到word R Markdown文档导出word 设置一新新建R Markdown文档直接写可能刚开始的时候没有在Markdown不显示图片，可以设置一下。我胡乱设置了一下就出来了写完之后导入到word 阅读详情

摘要

本文是一份面向初学者的 R Markdown 完整入门指南。你将学习到 R Markdown 的核心概念、在 RStudio 中的安装步骤、创建第一个包含 YAML 头部、文本和代码块的文件的方法，以及如何将其手动或通过代码导出为 PDF 和 Word 文档。通过本文，你可以快速上手并开始使用 R Markdown 创建动态、可重复的报告。

一、R Markdown 是什么？

R Markdown 是一种将 R 代码与 Markdown 轻量级标记语言相结合的文档格式。它允许你在同一个文档中无缝地混合编写文本叙述、R 代码及其运行结果（如图表、表格）。最终，你可以将这份动态文档“编织”（knit）成多种格式的静态报告，如 HTML、PDF、Word 等。

其核心优势在于“可重复性研究”（Reproducible Research）：数据分析、结果生成和报告撰写全部集成在一个文档中，确保结果可以随时被重新计算和验证。

二、安装 R Markdown

R Markdown 并非一个独立的软件，它作为 R 语言的一个扩展包运行。最便捷的使用方式是通过 RStudio 集成开发环境。

1. 前提条件

安装 R 语言。
安装 RStudio IDE（推荐 Desktop 版本）。

2. 安装 R Markdown 包

打开 RStudio，在控制台（Console）中运行以下命令来安装必要的包：

# 安装 rmarkdown 包
install.packages("rmarkdown")
如果你想生成 PDF 文档，通常还需要安装 TinyTeX 或 MiKTeX
安装 TinyTeX（一个轻量级的 LaTeX 发行版）
install.packages("tinytex")
tinytex::install_tinytex()

安装完成后，你可以通过 library(rmarkdown) 来加载它。

三、创建你的第一个 R Markdown 文档

1. 新建 R Markdown 文件

在 RStudio 中，点击菜单栏 File → New File → R Markdown…。在弹出的对话框中，你可以设置文档的标题、作者和默认输出格式（如 HTML、PDF、Word）。初次使用，选择默认的 HTML 格式即可。点击 “OK”，RStudio 会自动生成一个包含示例内容的新 .Rmd 文件。

2. 认识文档结构

一个新创建的 R Markdown 文件通常包含三个核心部分：

YAML 头部：被三个短横线 --- 包围的区域，用于设置文档的元数据，如标题、作者、日期和输出格式。
文本内容：使用 Markdown 语法编写，用于撰写报告的文字叙述部分。
代码块：被三个反引号 ```{r} 和 ``` 包围的区域，用于编写和运行 R 代码。

3. 编写与运行示例

以下是一个简单的 .Rmd 文件内容示例：

---
title: "我的第一个报告"
author: "你的名字"
date: "`r Sys.Date()`"
output: html_document
---
引言
这是一个用 R Markdown 创建的动态报告示例。
数据分析
下面我们加载 mtcars 数据集并查看其前几行。
# 加载数据
data(mtcars)
# 查看数据结构
head(mtcars)
可视化
我们绘制一个发动机排量（disp）与马力（hp）的散点图。
library(ggplot2)
ggplot(mtcars, aes(x=disp, y=hp)) +
  geom_point() +
  geom_smooth(method = "lm")
结论
报告生成成功！

四、R Markdown 的导出（Knit）

将 .Rmd 文件转换为最终报告的过程称为“编织”（Knit）。

1. 手动导出（推荐新手）

在 RStudio 中打开你的 .Rmd 文件，点击编辑器上方的 Knit 按钮（一个带有毛线球图案的按钮）。你可以从下拉菜单中选择输出格式（如 “Knit to HTML”、“Knit to PDF”、“Knit to Word”）。RStudio 会自动执行文档中的所有代码，并将结果与文本合并，生成最终的输出文件，并在预览窗格中打开。

2. 通过代码导出

你也可以在 R 控制台或脚本中使用 rmarkdown::render() 函数来生成报告，这便于自动化处理。

# 将当前目录下的 my_report.Rmd 渲染为 HTML
rmarkdown::render("my_report.Rmd", output_format = "html_document")
渲染为 PDF
rmarkdown::render("my_report.Rmd", output_format = "pdf_document")
渲染为 Word
rmarkdown::render("my_report.Rmd", output_format = "word_document")