This guide will help you set up Quarto, Visual Studio Code, and Python for literate programming (also known as entangling) on Windows.
- Windows operating system
- Python installed
- Visual Studio Code installed
-
Install Quarto
Choose one of the following methods:
-
Using Chocolatey (if installed):
choco install quarto -y
-
Using winget (if available):
winget install Quarto
-
-
Install required Python packages
Open a command prompt and run:
py -m pip install jupyter matplotlib plotly
Note: Only Jupyter is required for Quarto, but matplotlib and plotly are needed for the official example.
-
Install the Quarto VS Code Extension
Install the extension from the Visual Studio Marketplace.
-
Create a Quarto document
Open VS Code in your desired folder and create a new file with the
.qmd
extension. -
Ensure correct Python environment
Verify that VS Code is using the correct Python installation:
- Check Python version in PowerShell or cmd:
python --version where python
- If VS Code is not using the correct Python, update
settings.json
:{ "python.defaultInterpreterPath": "path\\to\\your\\python" }
- This can be set at the user, workspace, or folder level.
- Check Python version in PowerShell or cmd:
-
Render the document
Use the keyboard shortcut: Ctrl + Shift + K
For more details, check out the official Quarto tutorial.
This is a follow up to:
I have also shared this Gist here on Reddit.