{"id":77179,"date":"2026-06-23T09:30:25","date_gmt":"2026-06-23T09:30:25","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=77179"},"modified":"2026-06-23T09:30:27","modified_gmt":"2026-06-23T09:30:27","slug":"complete-practical-quarto-installation-command-guide","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/complete-practical-quarto-installation-command-guide\/","title":{"rendered":"Complete practical Quarto installation + command guide"},"content":{"rendered":"\n

Quarto is an open-source technical publishing system built on Pandoc. It can create documents, websites, blogs, books, and slides, and supports authoring in Markdown-like .qmd<\/code> files. It also supports executable content from Python, R, Julia, and JavaScript through Jupyter, Knitr, and Observable integrations. (GitHub<\/a>) For presentations, Quarto officially supports revealjs<\/code>, pptx<\/code>, and beamer<\/code>; Quarto\u2019s own docs say revealjs<\/code> is the most capable presentation format unless you specifically need Office or LaTeX output. (Quarto<\/a>)<\/p>\n\n\n\n

1. What you are going to build<\/h1>\n\n\n\n

For your course-slide automation system, the model should be:<\/p>\n\n\n

course-topic.qmd\n      \u2193\nquarto render \/ quarto preview\n      \u2193\nHTML reveal.js slides\nPDF\nPPTX\nwebsite\nhandouts\n<\/code><\/span><\/pre>\n\n\n
For your current folder:<\/p>\n\n\n
cd ~\/slides\nls\n<\/code><\/span><\/pre>\n\n\n
You already have:<\/p>\n\n\n
Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.qmd<\/span>\nIntroduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.marp<\/span>.md<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
For Quarto, we will mainly work with:<\/p>\n\n\n
Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.qmd<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
2. Install Quarto on macOS<\/h1>\n\n\n\n
Option A: Install using Homebrew<\/h2>\n\n\n\n
This is the easiest on your Mac:<\/p>\n\n\n
brew install --cask quarto\n<\/code><\/span><\/pre>\n\n\n
Check version:<\/p>\n\n\n
quarto --version\n<\/code><\/span><\/pre>\n\n\n
Check location:<\/p>\n\n\n
which quarto\n<\/code><\/span><\/pre>\n\n\n
Run Quarto health check:<\/p>\n\n\n
quarto check\n<\/code><\/span><\/pre>\n\n\n
Quarto\u2019s getting-started page directs users to install Quarto first and then choose an authoring tool such as VS Code, Jupyter, RStudio, Positron, Neovim, or a normal text editor. (Quarto<\/a>)<\/p>\n\n\n\n
Option B: Install manually<\/h2>\n\n\n\n
Download the macOS installer from the official Quarto download page and install it like a normal .pkg<\/code> application.<\/p>\n\n\n\n
After install:<\/p>\n\n\n
quarto --version\nquarto check\n<\/code><\/span><\/pre>\n\n\n
Option C: Install Homebrew first, then Quarto<\/h2>\n\n\n\n
If Homebrew itself is not installed:<\/p>\n\n\n
\/bin\/bash -c \"$(curl -fsSL https:\/\/raw.githubusercontent.com\/Homebrew\/install\/HEAD\/install.sh)\"<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Then:<\/p>\n\n\n
brew install --cask quarto\nquarto --version\n<\/code><\/span><\/pre>\n\n\n
Homebrew describes itself as a package manager for macOS, Linux, and WSL. (Homebrew<\/a>)<\/p>\n\n\n\n
3. Install Quarto on Windows<\/h1>\n\n\n\n
Preferred method: use the official Windows installer from Quarto\u2019s download page.<\/p>\n\n\n\n
After install, open PowerShell<\/strong> and run:<\/p>\n\n\n
quarto --version\nquarto check\n<\/code><\/span><\/pre>\n\n\n
Optional Winget method:<\/p>\n\n\n
winget<\/span> search<\/span> Quarto<\/span>\nwinget<\/span> install<\/span> Posit<\/span>.Quarto<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Then close and reopen PowerShell:<\/p>\n\n\n
quarto --version\n<\/code><\/span><\/pre>\n\n\n
If Windows says quarto is not recognized<\/code>, restart the terminal or check whether Quarto\u2019s install directory was added to PATH<\/code>.<\/p>\n\n\n\n
4. Install Quarto on Linux<\/h1>\n\n\n\n
For Ubuntu\/Debian, use the official .deb<\/code> package.<\/p>\n\n\n\n
Common latest-download style:<\/p>\n\n\n
wget https:\/\/quarto.org\/download\/latest\/quarto-linux-amd64.deb<\/span>\nsudo apt install .\/quarto-linux-amd64.deb\nquarto --version\nquarto check\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
For Red Hat\/CentOS\/Fedora style systems, use the .rpm<\/code> package from the Quarto download page.<\/p>\n\n\n\n
5. Install recommended editor support<\/h1>\n\n\n\n
VS Code<\/h2>\n\n\n\n
Install VS Code extension:<\/p>\n\n\n
code<\/span> --install-extension<\/span> quarto<\/span>.quarto<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Or open VS Code:<\/p>\n\n\n
Extensions \u2192 Search \u201cQuarto\u201d \u2192 Install\n<\/code><\/span><\/pre>\n\n\n
Then open your folder:<\/p>\n\n\n
cd ~\/slides\ncode .\n<\/code><\/span><\/pre>\n\n\n
Recommended VS Code extensions for your workflow:<\/p>\n\n\n
Quarto\nMarkdown All in One\nYAML\nMermaid Markdown Syntax Highlighting\nGitLens\n<\/code><\/span><\/pre>\n\n\n
6. First Quarto commands to run<\/h1>\n\n\n\n
Go to your slides folder:<\/p>\n\n\n
cd ~\/slides\n<\/code><\/span><\/pre>\n\n\n
Check Quarto:<\/p>\n\n\n
quarto --version\nquarto check\n<\/code><\/span><\/pre>\n\n\n
Preview your slide deck:<\/p>\n\n\n
quarto<\/span> preview<\/span> Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.qmd<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Render your slide deck:<\/p>\n\n\n
quarto<\/span> render<\/span> Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.qmd<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Render specifically to reveal.js HTML slides:<\/p>\n\n\n
quarto<\/span> render<\/span> Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.qmd<\/span> --to<\/span> revealjs<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Render to PowerPoint:<\/p>\n\n\n
quarto<\/span> render<\/span> Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.qmd<\/span> --to<\/span> pptx<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Render to PDF:<\/p>\n\n\n
quarto<\/span> render<\/span> Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.qmd<\/span> --to<\/span> pdf<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
The official CLI docs describe quarto render<\/code> as the command for rendering files or projects to different document types, with options like --to<\/code>, --output<\/code>, --output-dir<\/code>, --metadata<\/code>, --execute<\/code>, and --execute-param<\/code>. (Quarto<\/a>)<\/p>\n\n\n\n
7. Most important Quarto commands<\/h1>\n\n\n\n
Command<\/th>Purpose<\/th><\/tr><\/thead>
quarto --version<\/code><\/td>Show installed Quarto version<\/td><\/tr>
quarto check<\/code><\/td>Verify Quarto installation<\/td><\/tr>
quarto tools<\/code><\/td>Show installed dependencies\/tools<\/td><\/tr>
quarto render file.qmd<\/code><\/td>Render one file<\/td><\/tr>
quarto preview file.qmd<\/code><\/td>Preview with live reload<\/td><\/tr>
quarto render<\/code><\/td>Render current project<\/td><\/tr>
quarto create project<\/code><\/td>Create a project<\/td><\/tr>
quarto install tinytex<\/code><\/td>Install TinyTeX for LaTeX PDF output<\/td><\/tr>
quarto install chrome-headless-shell<\/code><\/td>Install headless browser dependency<\/td><\/tr>
quarto publish<\/code><\/td>Publish document\/project<\/td><\/tr>
quarto inspect<\/code><\/td>Inspect project\/input configuration<\/td><\/tr>
quarto add<\/code><\/td>Add extension<\/td><\/tr>
quarto remove<\/code><\/td>Remove extension<\/td><\/tr>
quarto update<\/code><\/td>Update extension or dependency<\/td><\/tr>
quarto pandoc<\/code><\/td>Run bundled Pandoc<\/td><\/tr>
quarto typst<\/code><\/td>Run bundled Typst<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
The Quarto CLI reference lists the main commands, including render<\/code>, preview<\/code>, create<\/code>, use<\/code>, add<\/code>, update<\/code>, remove<\/code>, convert<\/code>, pandoc<\/code>, typst<\/code>, run<\/code>, install<\/code>, uninstall<\/code>, tools<\/code>, publish<\/code>, capabilities<\/code>, inspect<\/code>, and check<\/code>. (Quarto<\/a>)<\/p>\n\n\n\n
8. Create your first simple Quarto slide file<\/h1>\n\n\n\n
Create a test folder:<\/p>\n\n\n
mkdir -p ~\/slides\/<\/span>quarto-test\/images\ncd ~\/slides\/<\/span>quarto-test\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Create a file:<\/p>\n\n\n
cat > openshift-intro.qmd <<'EOF'<\/span>\n---\ntitle: \"Introduction to Red Hat OpenShift\"<\/span>\nsubtitle: \"DevOpsSchool Training\"<\/span>\nauthor: \"Rajesh Kumar\"<\/span>\nformat:\n  revealjs:\n    theme: simple\n    slide-number: true<\/span>\n    transition: slide\n---\n\n# Introduction<\/span>\n\n## What is OpenShift?<\/span>\n\nRed Hat OpenShift is an enterprise Kubernetes platform.\n\n---\n\n## Why OpenShift?<\/span>\n\n- Enterprise Kubernetes\n- Built-in security\n- Developer experience\n- Integrated CI\/CD\n- Operators\n- Monitoring\n\n---\n\n## Example Command<\/span>\n\n```bash\noc get projects\noc get pods -A\noc get routes -A\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
Summary<\/h2>\n\n\n\n
Quarto also provides Linux tarball installation for single-user setups. (Quarto<\/a>)<\/p>\n\n\n\n