快捷方式与选项
快捷方式
视觉模式支持传统的键盘快捷方式(例如,⌘ 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 快捷方式,如果您无意使用快捷方式并希望撤销其效果,只需按退格键。
插入任何内容
您还可以使用万能快捷方式 ⌘ / 来插入几乎任何内容。只需执行快捷方式,然后输入您想要插入的内容。例如:
如果您在行首(如上图所示),也可以直接输入 /
来调用快捷方式。
全局选项
您可以在 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编写选项的更多详细信息,请参阅编写器选项的文档。