文本编辑器

概述

如果你正在编辑纯 Markdown 文档（不包含嵌入的计算），你可能希望使用你喜欢的文本编辑器（如 Vim、Emacs、Sublime 等）来编写 Quarto 文档。本文提供了在使用文本编辑器时与 Quarto 配合的最佳工作流程的一些指导。

请注意，如果你使用的是 Jupyter 或 Knitr 计算引擎，你可能会发现使用 JupyterLab 或 VS Code（适用于 .ipynb 笔记本）或 RStudio（适用于 .qmd 文档）更为合适，因为这些环境提供了代码补全、增量单元格执行以及其他与可执行代码相关的实用工具。

编写 Quarto Markdown 文档的理想工作流程是从终端运行 quarto preview 命令：

终端

quarto preview document.qmd

文档将被渲染，并打开一个带有“实时预览”的网页浏览器。将浏览器定位在你编辑和保存文档时可以看到的位置：

两个应用程序窗口并排排列。一个包含本网站欢迎页面内容的 Quarto 文档在右侧打开。该文档的内容通过 Quarto 在右侧窗口的网页浏览器中渲染。

每次保存时，预览都会自动更新。你可以对 HTML 和 PDF 输出使用 quarto preview。

预览使用文档中指定的默认格式——要使用其他格式，请将 --to 选项传递给 quarto preview。例如：

终端

quarto preview notebook.qmd --to pdf

请注意，如果你正在编写书籍或网站，你也可以在项目目录上使用 quarto preview，这将创建整个项目的实时预览。

你可以使用 quarto render 命令在不预览的情况下渲染文档（或一组文档）：

终端

quarto render document.qmd

使用 --to 参数渲染为特定格式：

终端

quarto render document.qmd --to docx

大多数文本编辑器都有适用于 Markdown 文件的语法高亮模式（通常带有 .md 扩展名）。你可能希望配置编辑器，使其也将 .qmd 扩展名识别为包含 Markdown 内容。