Use Quarto and create a PowerPoint slideshow
Discover how to convert your Markdown documentation into a PowerPoint (.pptx) slideshow or an online reveal.js presentation using Quarto.
This article is over a year old but was reviewed on July 30, 2026 — the content is still accurate.
This article is part of the Discovering Quarto series:
- Running Quarto Markdown in Docker
- Quarto conditional display
- Use Quarto and create a PowerPoint slideshow
- Using variables from external file in your Quarto project
- Some tips and tricks for Quarto when rendering as a reveal.js slideshow
- Quarto Callout Blocks
- Quarto includes short code
- Quarto Inline style
- My favorite Quarto extensions
- Using Mustache templating with Quarto
- Make your Quarto project Devcontainer-Ready — No More Setup Headaches
- Quarto - How I Built a Self-Documenting Ecosystem for 50+ Projects

This article shows how to convert a Markdown file into a PowerPoint .pptx deck with quarto render slides.md --to pptx, where level-2 headings become slide titles and a --- line starts a new section — noting the same source can instead be rendered to an online reveal.js slideshow with --to revealjs.
Quarto can convert a Markdown file to a revealjs HTML slideshow but can also create a pptx file that you can open and play in Microsoft PowerPoint.
In this article, we'll create a pptx file from our Markdown documentation.
From Markdown to PowerPoint in one command
Take a plain Markdown file called slides.md and run:
Open the .pptx that comes out, and this is your first slide:

The rule is worth remembering because it's the whole syntax: every ## heading becomes a slide title, and a --- line starts a new slide. Your document structure is your slide structure.
The source file
Here is the slides.md that produced the deck — the content is filler, the structure is what matters:
---
title: "My thesis in Latin"
---
## Chapter 1
<!-- cspell:disable -->
Voluptatem minus labore architecto sed voluptas molestiae perferendis.
Expedita magni facere. Ullam non non sint qui provident.
## Chapter 2
Iure repudiandae perferendis maiores dolorem consequuntur exercitationem suscipit.
---
### Chapter 2.1
Quis voluptate est quis in ea veniam qui incididunt ad cillum nostrud.
And the three remaining slides it generates:



You'll find a lot of tips and tricks on the official documentation page.
Docker image with Quarto
If you don't have yet a Docker image with Quarto, read this article Running Quarto Markdown in Docker.
Conclusion
The nice thing here isn't that Quarto makes PowerPoint files — it's that your documentation and your slide deck become the same file. Update a chapter, re-render, and the presentation is up to date. No copy/paste into a slide editor, no two versions of the same content drifting apart.
And the very same slides.md renders as an online slideshow: run quarto render slides.md --to revealjs instead, put the result on a web server, and everyone can consult your work from a browser. See Quarto - revealjs tips for what you can do with it.
This article is part of the Discovering Quarto series:
- Running Quarto Markdown in Docker
- Quarto conditional display
- Use Quarto and create a PowerPoint slideshow
- Using variables from external file in your Quarto project
- Some tips and tricks for Quarto when rendering as a reveal.js slideshow
- Quarto Callout Blocks
- Quarto includes short code
- Quarto Inline style
- My favorite Quarto extensions
- Using Mustache templating with Quarto
- Make your Quarto project Devcontainer-Ready — No More Setup Headaches
- Quarto - How I Built a Self-Documenting Ecosystem for 50+ Projects





