快捷方式与选项

快捷方式

视觉模式支持传统的键盘快捷方式(例如,⌘ B 用于加粗)以及 Markdown 快捷方式(直接使用 Markdown 语法)。例如,将 **bold** 文本用星号括起来,或输入 ## 并按空格键以创建二级标题。

以下是可用的键盘和 Markdown 快捷方式:

命令 键盘快捷方式 Markdown 快捷方式
加粗 ⌘ B **bold**
斜体 ⌘ I *italic*
代码 ⌘ D `code`
删除线 ~~strike~~
下标 ~sub~
上标 ^super^
标题 1 ⌥⌘ 1 #
标题 2 ⌥⌘ 2 ##
标题 3 ⌥⌘ 3 ###
标题属性 {#id .class}
链接 ⌘ K <href>
引用 >
代码块 ⇧⌘ \ ```
R 代码块 ⌥⌘ I ```{r}
原始块 ```{=html}
分隔块 :::
无序列表 -
有序列表 1.
紧凑列表 ⌥⌘ 9
列表勾选 [x]
表情符号 :smile:
定义 :
不间断空格 ⌃ Space
强制换行 ⇧ Enter
段落 ⌥⌘ 0
图片 ⇧⌘ I
脚注 ⇧⌘ F7
引用 ⇧⌘ F8 [@
表格 ⌥⌘ T
编辑注释 ⇧⌘ C
全选 ⌘ A
清除格式 ⌘ \
编辑属性 F4
运行代码块 ⇧⌘ Enter
运行前面的代码块 ⇧⌥⌘ P

对于 Markdown 快捷方式,如果您无意使用快捷方式并希望撤销其效果,只需按退格键。

插入任何内容

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

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

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

如果您在行首(如上图所示),也可以直接输入 / 来调用快捷方式。

全局选项

您可以在 R Markdown -> Visual 中自定义视觉编辑选项(请注意,视觉编辑器最初是为与 R Markdown 一起使用而创建的,因此其选项位于该处——这些选项也适用于与 Quarto 一起使用):

选项 描述
默认使用可视化编辑 创建新文档时立即切换到可视化模式。
默认显示文档大纲 在可视化模式下打开文档时显示导航大纲。
编辑器内容宽度 编辑内容的最大宽度。目的是保持编辑宽度与用户将看到的宽度相似。
编辑器字体大小 编辑器内容的基本字体大小(默认:继承自IDE设置)。
在代码块中显示边距列指示器 显示指示编辑边距列位置的垂直线(例如80)。
列表项之间的默认间距 默认情况下列表项之间使用紧密或正常间距。详见紧密列表
自动文本换行(换行) 在编写markdown时,自动在句子后或指定列处插入换行符(默认:流式文本;不自动换行)。详见换行
在当前结尾处写入引用 在引用(脚注)出现的位置块或部分的末尾,或在文档末尾写入引用。详见引用
在源代码模式下写入规范的可视化模式markdown 保存源代码模式的markdown时使用可视化模式markdown写入器(确保从任一模式保存的文档之间的一致性)。

引用选项

您可以在 R Markdown -> 引用 中自定义可视化编辑器的引用选项:

选项 描述
Zotero 图书馆 Zotero 引用库的位置(本地或网络)。
Zotero 数据目录 Zotero 本地数据目录的位置。
使用图书馆 用作参考来源的Zotero图书馆。
使用 Better BibTeX 生成引用键和 BibTeX 导出 可选地使用 Better BibTeX 从Zotero生成引用键并导出BibTeX(仅当安装了Better BibTeX时此选项才会出现)。

项目选项

影响markdown编写方式的全局选项也可以在每个项目的基础上进行自定义。您可以使用 项目选项 对话框的 R Markdown 窗格来完成此操作:

默认情况下,项目继承当前的全局设置用于markdown编写和Zotero图书馆。 影响Markdown编写方式的全局和项目选项也可以在每个文件的基础上进行自定义。你可以通过在文档的YAML前言中包含一个editor: markdown键来实现这一点。例如:

---
title: "我的文档"
author: "简·多伊"
editor:
  markdown:
    wrap: 72
---

你可能希望这样做,以确保在不同工作站上的多个作者使用相同的Markdown编写选项。

你还可以指示RStudio在从源模式保存文件时使用这些相同的选项。为此,添加canonical选项。例如:

---
editor:
  markdown:
    wrap: 72
    canonical: true
---

canonical: true时,视觉模式和源模式中的编辑将产生相同的Markdown输出。如果你有多个作者使用版本控制进行协作,并且这些作者中混合使用源模式和视觉模式编辑,这一点尤其有用。

有关Markdown编写选项的更多详细信息,请参阅编写器选项的文档。