内容编辑

视觉模式支持编辑所有Pandoc Markdown内容。标准的格式化命令（标题、加粗、斜体等）的工作方式与传统文字处理器中的方式相同。

有关如何访问核心编辑命令的更多详细信息，请参阅使用编辑器部分。还请注意，您可以通过键盘快捷键访问所有编辑命令。

链接、图像、块引用、列表、表格等的编辑也是可用的，还可以指定Pandoc属性并插入特殊字符和表情符号。

编辑表格

您可以使用表格菜单插入表格。然后，您可以使用主菜单或上下文菜单插入和删除表格行和列：

请注意，如果您选择了多行或多列，插入或删除命令将相应地执行。例如，要插入2行，首先选择2行，然后使用插入命令。

当您如上图所示选择多行或多列时，您还可以在表格内复制和粘贴单元格组。

编辑列表

如上所述，您可以通过在空段落的开头键入-或1.来创建新列表。要向列表添加项目，只需在列表项内按Enter。要退出列表，请在空列表项内按Enter。

虽然这涵盖了许多简单的列表编辑任务，但您可能希望在列表中执行其他各种操作，包括创建嵌套列表和向现有列表项添加段落或代码块。从空列表项（如图所示）开始，可以使用以下键盘手势来执行这些操作：

空项（按Enter退出列表）	Tab （添加子列表）	Backspace （添加块）

您还可以使用Shift+Tab将列表项提升到上一级。

紧凑列表

Markdown区分普通列表和紧凑列表，紧凑列表在项目之间有较少的垂直间距。在Markdown源代码中，您可以通过在列表项之间没有空行来指定紧凑列表。

视觉模式默认创建普通列表（您可以通过编辑器选项更改此行为）。您可以使用⌥⌘ 9键盘快捷键在普通列表和紧凑列表之间切换。您还可以使用格式 -> 编辑属性对话框（也可以通过F4快捷键访问）更改列表类型。如果您在Markdown源文件中有现有的紧凑列表，它们将在视觉编辑器中保持不变。

Pandoc属性

Pandoc的几种块类型（例如标题、代码块和div）允许您指定一组自定义属性。属性包括ID和类名，以及传递给输出格式的任意键值对（例如作为HTML标签的属性）。对于这些块类型，当光标位于块内时，右上角将出现一个编辑按钮：

请注意，任何ID以及属性中指定的第一个类也会显示。单击编辑按钮或使用F4键盘快捷键来编辑属性。

特殊字符

硬换行

您可以使用插入 -> 特殊字符 -> 硬换行命令或通过⇧ Enter键盘快捷键插入硬换行。

不间断空格

您可以使用插入 -> 特殊字符 -> 不间断空格命令或通过⌃ Space键盘快捷键插入不间断空格。不间断空格以不同的背景颜色显示，以区别于普通空格。

Markdown中的不间断空格将在HTML输出中生成 字符，在LaTeX输出中生成~字符。

表情符号

要插入表情符号，您可以使用插入菜单或相应的Markdown快捷键加上自动补全：

插入 -> 特殊字符 -> 表情符号…	Markdown快捷键

对于支持表情符号文本表示的markdown格式（例如 :grinning:），将写入文本版本。对于其他格式，将写入字面表情符号字符。目前，gfm 和 hugo（在站点配置中启用 enableEmoji = true）格式都支持表情符号的文本表示。

如果你想为另一种 Quarto 格式添加对 markdown 表情符号输出的支持，可以在文档元数据中的 from 选项中添加 emoji 扩展。例如：

---
title: "我的文档"
from: markdown+emoji
---

Unicode 符号

要插入任意 Unicode 字符，请使用 插入 -> 特殊字符 -> Unicode…：

你可以通过名称或输入显式的 Unicode 代码点（例如 “U+0420”）来搜索字符。

智能标点

当启用 Pandoc 的 smart 扩展（默认启用）时，直引号被解释为卷曲引号，--- 被解释为长破折号，-- 被解释为短破折号，... 被解释为省略号。此外，某些缩写词（如 “Mr.”）后会插入不间断空格。

视觉模式支持这些相同的转换（因此当你输入 --- 时，它会变成一个长破折号）。如果你不希望发生这种转换，只需按退格键即可恢复。

拼写检查

当启用 RStudio 实时拼写检查（你可以通过拼写首选项进行设置）时，拼写错误的单词在输入时会被下划线标记：

要解决拼写错误，右键点击拼写错误的单词，然后选择一个替代拼写，忽略该单词（仅适用于当前文档），或将其添加到用户字典中（适用于所有文档）。

如果你错误地忽略了某个单词，再次右键点击它以取消忽略。如果你想编辑个人字典，请使用拼写首选项中的 编辑用户字典… 按钮。

在审查文档时，你经常希望提供带有修订建议的内联评论。Quarto 可以使用 HTML 评论（所有输出格式都会忽略这些评论）来实现这一点。视觉模式包括插入 HTML 评论的命令以及特殊的高亮处理，以便轻松从周围文本中解析出编辑评论。

请注意，评论中使用的 # 前缀是触发特殊背景高亮的关键。如果你移除 #，它仍然是一个有效的 HTML 评论，但不会如上所示高亮显示。

你可以使用工具栏上的评论按钮或通过 ⇧⌘ C 键盘快捷键插入 HTML 评论。记住，HTML 评论不会在渲染输出中显示，因此它们既适合用于审查，也适合用于在文档中留下待办事项。

CSS 样式

使用 markdown 创作的一个好处是，你的内容可以轻松发布到各种格式。这在很大程度上是因为 markdown 施加的限制：你以内容结构和语义的方式进行创作，而不是担心具体的表现形式。

然而，有时你知道你将发布到 HTML，并且你希望对事物的表现形式有更多的控制。在这种情况下，你可以将 CSS（层叠样式表）与 markdown 结合使用进行自定义格式化。本节介绍如何：

为你的文档定义 CSS 样式；以及
将这些样式应用于文档中的实体。

如果你不熟悉 CSS，建议在继续之前复习一下基础知识。

CSS 样式仅适用于 HTML 输出，不会对其他输出类型（如 PDF 或 MS Word）的格式产生任何影响。

定义样式

包含 CSS 样式的最佳方式是创建一个外部样式表（例如 styles.css），然后将其包含在文档的输出选项中。例如：

---
title: "CSS 演示"
format:
  html:
    css: styles.css
---

styles.css 文件可能看起来像这样：

.important {
  color: maroon;
}

.illustration {
  border: 1px solid rgb(230, 230, 230); 
}

请注意，也可以通过 CSS 代码块内联定义样式，但我们建议使用外部文件以方便管理。在Markdown文档中，你可以将一个或多个CSS类应用于包括标题、图片、div和span等各种文档实体。CSS类通过Pandoc属性应用。一旦你将一个类应用于某个实体，它将根据指定类的CSS属性获得其格式。

标题

要将CSS类添加到标题，请使用标题右侧的编辑按钮，当你的光标位于标题内部时会出现该按钮（或使用F4快捷键）：

注意编辑属性对话框中.important类的存在。

应用于标题的CSS类会影响标题下方的所有内容（Pandoc会将内容包裹在一个HTML <section>标签中），因此标题类是为你文档的整个部分提供自定义样式的好方法。

请注意，视觉编辑器目前不会使用通过CSS类应用的样式渲染内容，因此在编辑时你不会看到自定义格式。然而，在渲染和预览文档的HTML版本时，你会看到这些样式。

图片

你可以使用标准的图片对话框将CSS类应用于图片（例如，给它们加上特殊边框）。要这样做，双击图片（或在使用F4快捷键并选中图片时）并应用所需的类：

再次注意，视觉编辑器在编辑时不会显示应用了CSS类的图片，但在实际渲染文档到HTML时，你会看到样式生效。

Divs

Div是特殊实体，允许你为文档的某个区域应用标识符和/或样式。Div是块级元素（如段落）。

你可以使用插入 -> Div命令创建div，并且你可以以应用于标题属性的相同方式为div应用属性（包括CSS类）（点击编辑按钮或在使用F4快捷键并位于div内部时）：

注意Div属性对话框中.important类的存在。

Spans

Span是特殊实体，允许你为文本的某个区域应用标识符和/或样式。Span是内联格式标记（如粗体或斜体）。

可以通过选择文本并使用格式 -> Span命令创建Span：

这里我们为文本“customize PDF reports”应用了一个span，并使用span应用了.important CSS类。注意，与标题和图片一样，格式在视觉编辑器中不会显示，但在文档渲染时会可见。