quarto-vscodeVS Code extension for the Quarto scientific and technical publishing system. This extension provides language support for Quarto
InstallationThe easiest way to install is directly from within VS Code (search extensions for "quarto"). You can also install from the VS Code Extension Marketplace, the Open VSX Registry or directly from a VISX extension file. Render and PreviewThe Quarto VS Code extension includes commands and keyboard shortcuts
for rendering Quarto documents (both standalone and within websites or
books). After rendering, To render and preview, execute the Quarto: Render command. You can alternatively use the Ctrl+Shift+K keyboard shortcut, or the Render button at the top right of the editor: Note that on the Mac you should use Additionally, there are commands available to render specific formats. Here is a complete list of the supported render commands:
The Quarto: Render command renders the default format of the currently active document. The other commands render specific formats (regardless of the document’s default format). The Ctrl+Shift+K keyboard shortcut will re-execute the most recently executed render command.
Render on SaveBy default Quarto does not automatically render However, you can configure the Quarto extension to automatically render whenever you save. You can do this either within VS Code settings or within the YAML options for your project or document. To configure the VS Code setting, search for You might also want to control this behavior on a per-document or per-project basis. If you include the
External PreviewIf you prefer to use an external browser for preview (or have no preview triggered at all by rendering document) you can use the Preview Type option to specify an alternate behavior: Code CellsThere are a variety of tools that make it easier to edit and execute code cells. Editing tools include syntax highlighting, code folding, code completion, and signature tips: For Python, R, and Julia cells, commands are available to execute the current cell, previous cells, or the currently selected line(s). Cell output is shown side by side in the Jupyter interactive console: Execute the current cell with Enhanced features for embedded languages (e.g. completion, code execution) can be enabled by installing the most recent version(s) of these extensions: Note that you can quickly insert a new code cell using the
Contextual AssistanceExecute the Quarto: Show Assist Panel command to show a panel in the sidebar that shows contextual assistance depending on the current cursor location:
For example, below help on the matplotlib Live PreviewWhile editing LaTeX math or Mermaid and Graphviz diagrams, click the Preview button above the code to open a live preview which will update automatically as you edit. Here we see a preview of the currently edited LaTeX equation displayed in the Quarto assist panel: Here we see a Graphviz diagram preview automatically updated as we edit: YAML IntelligenceYAML code completion is available for project files, YAML front matter, and executable cell options: If you have incorrect YAML it will also be highlighted when documents are saved: Note that YAML intelligence features require version 0.9.44 or later of the Quarto CLI. Code SnippetsCode snippets are templates that make it easier to enter repeating code patterns (e.g. code blocks, callouts, divs, etc.). Execute the Insert Snippet command within a Quarto document to insert a markdown snippet: Document NavigationIf you have a large document use the outline view for quick navigation between sections: You can also use the Use the Notebook EditorIn addition to editing Quarto document as plain-text YAML Front MatterThe first cell of your notebook should be a Raw cell that contains the document title, author, and any other options you need to specify. Note that you can switch the type of a call to Raw using the cell type menu at the bottom right of the cell: Markdown CellsHere’s the underlying code for the markdown cell: Note that a Quarto cross-reference ( Output OptionsQuarto uses leading comments with a special prefix ( Note that options must appear at the very beginning of the cell. As with document front-matter, option names/values use YAML syntax. |