Quarto Wingman

Quarto Wingman is a Positron extension designed to enhance the editing experience for Quarto documents and scripts

Author

Affiliation

Luong Nguyen Thanh

Github

Open Marketplace site Code

Quarto Wingman

Quarto Wingman is a Positron extension designed to enhance the editing experience for Quarto documents and scripts. It provides interactive code cell configuration based on Quarto documentation, improved syntax highlighting for Python code (particularly when Pylance is not available), and intelligent token recognition for module imports, function calls, and variable declarations. Additionally, it enhances footnote display in documents and offers an inline code runner for R and Python scripts, making it especially useful for data exploration. Developed with modern data science workflows in mind, Quarto Wingman brings a streamlined, polyglot data science IDE experience to Positron users.

Features

• Provide code cell options for quarto document. The documentation was refered from Quarto Homepage

• Improving syntax highlighting for Python code in .qmd document. This function is useful when Pylance is not available. You can use Developer: Inspect Editor Tokens and Scopes to inspect which are available token:

  • Module keywords: Identify module name and module alias (like import numpy as np).

  • Function Call Enhancement: In function calls that use dot notation, the token before the dot (object name) and the function name are captured.

  • Variable Declaration Highlighting: Variable declarations are detected by matching identifiers followed by an equals sign, while avoiding matches when they are part of object attribute assignments.

• Highlighting footnote, both in-line footnote and block footnote references or definitions (e.g., [^1]: Note content or [^1] references). Three new token are introduced including meta.footnote.inline.quarto, meta.footnote.reference.quarto, meta.footnote.definition.quarto

• Add a Run Inline Code button to .r and .py script that allows user to run code in comment. It is useful for data exploration task where you want to keep the experiment code in your script without interfere the entire workflow. For now the feature only works in Positron.

🙏 Attribution

Created by ntluong95
Licensed under the MIT License

💡 Future Ideas

• Snippets for different type of Quarto project
• Add support for Run Inline Code for VSCode users

🧠 Why Positron?

Because it’s time for a modern, polyglot, VS Code-based Data Science IDE — and this extension brings one of RStudio’s most beloved panels to the future.