RStudio中的可视化编辑

概述

Quarto可视化编辑器提供了一个WYSIWYM编辑界面,支持所有Pandoc Markdown功能,包括表格、引用、交叉引用、脚注、div/span、定义列表、属性、原始HTML/TeX等。可视化编辑器还支持执行代码单元并查看其内联输出:

在RStudio可视化编辑器中打开的RMarkdown文件。页面标题为'Filter joins'。下方是一个包含R语法、数学符号和半连接与反连接定义的表格。表格下方是一个R代码块,显示了半连接的图形表示。

可视化编辑器并不试图抽象或隐藏底层Markdown文档,而是旨在为喜爱Markdown的人提供一个高效的写作界面。你仍然可以直接使用大多数Markdown结构(例如,##或粗体)进行格式化。

切换模式

Markdown文档可以在源代码模式或可视化模式下编辑。要切换到某个文档的可视化模式,请使用文档工具栏左上角的源代码可视化按钮(或者使用⌘⇧ F4快捷键):

RStudio窗口的片段,显示了Quarto文档顶部的选项栏。

请注意,你可以在任何时候在源代码和可视化模式之间切换(切换时会保留编辑位置和撤销/重做状态)。

入门指南

Quarto可视化编辑器目前作为RStudio IDE的一个功能提供。可视化编辑器最终也将以独立形式提供。

要开始使用可视化编辑器,请从以下链接下载适用于你平台的最新版RStudio(v2023.12):

https://posit.co/download/rstudio-desktop/

使用编辑器

键盘快捷键

所有基本编辑任务都有键盘快捷键。可视化模式支持传统的键盘快捷键(例如⌘ B用于加粗)以及Markdown快捷键(直接使用Markdown语法)。例如,用星号括起**bold**文本,或键入##并按空格键创建二级标题。以下是一些最常用的快捷键:

命令 键盘快捷键 Markdown快捷键
加粗 ⌘ B **bold**
斜体 ⌘ I *italic*
代码 ⌘ D `code`
一级标题 ⌥⌘ 1 #
二级标题 ⌥⌘ 2 ##
三级标题 ⌥⌘ 3 ###
链接 ⌘ K <href>
R代码块 ⌥⌘ I ```{r}

查看编辑快捷键文章以获取所有快捷键的完整列表。

插入任何内容

你还可以使用万能的⌘ /快捷键插入几乎任何内容。只需执行快捷键,然后输入你想要插入的内容。例如:

有一行文本(光标在末尾),某人输入了'/lis'。下方有一个下拉菜单,垂直排列着'Bullet List'、'Numbered List'和'Definition List'选项。每个项目的标题加粗,左侧有一个小图标,下方有一行浅灰色的小描述。

有一行文本(光标在末尾),某人输入了'/ma'。下方有一个下拉菜单,垂直排列着'Inline Math'、'Display Math'和'Image...'选项。每个项目的标题加粗,左侧有一个小图标,下方有一行浅灰色的小描述。

如果你在一行的开头(如上所示),也可以直接输入/来调用快捷键。

编辑器工具栏

编辑器工具栏包括最常用格式化命令的按钮:

RStudio窗口的片段,显示了RMarkdown文档顶部的选项栏。

格式插入表格菜单中还提供了其他命令:

格式 插入 表格
格式下拉菜单的内容。 插入下拉菜单的内容。 表格下拉菜单的内容。

进一步学习

查阅以下文章以了解更多关于视觉化Markdown编辑的信息:

  • 技术写作 涵盖了在科学和技术写作中常用的功能,包括引用、交叉引用、脚注、方程、嵌入代码和LaTeX。

  • 内容编辑 提供了关于视觉编辑器对表格、列表、pandoc属性、CSS样式、注释、符号/表情符号等支持的更多深度。

  • 快捷方式与选项 文档介绍了两种可以与编辑器一起使用的快捷方式:标准键盘快捷方式和Markdown快捷方式,并描述了配置编辑器的各种选项。

  • Markdown输出 描述了视觉编辑器如何解析和编写Markdown,并介绍了多种自定义此功能的方法。