Skip to main content

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.

· 3 min read
View raw
Christophe
Markdown, WSL and Docker lover ~ Insatiable curious.
Cet article existe aussi en français — lire la version française.

This article is over a year old but was reviewed on July 30, 2026 — the content is still accurate.

Use Quarto and create a PowerPoint slideshow

⚡
TL;DR

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:

>user@machine: ~/yourproject

Open the .pptx that comes out, and this is your first slide:

PowerPoint - Slide 1

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:

PowerPoint - Slide 2

PowerPoint - Slide 3

PowerPoint - Slide 4

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.


Was this article helpful?
Did you try the steps in this article?