mdx-deck
Build slide presentations in React using MDX, with a zero-config setup.
- Stars
- 11.5k
- Forks
- 595
- Licence
- MIT
- Language
- JavaScript
- Last update
- 3.8 years ago
- Type
- Dev tool
No commits in over a year — check for forks or alternatives before adopting.
What it is
mdx-deck is a tool for making slide presentations by writing Markdown mixed with React components (MDX). Each slide is written as content in a file, and the tool turns the file into a deck you can present in a browser. It is aimed at people who already work with React and want slides that can include live components or code.
- Write a conference talk as a set of MDX slides and present it in a browser
- Include a live React component or interactive demo inside a slide
- Keep slide content in version control alongside a project's code
Great for
- Developers who already write React and want to present technical material
- Teams that keep documentation in Markdown and want slides from the same source
- People who want a zero-config starting point for a web-based deck
Not ideal for
- Non-technical users who want a visual slide editor, since it requires writing code and MDX files
- People who need a finished PowerPoint or Keynote file, since output is a web presentation
- Anyone unwilling to set up a Node.js project, because the README describes a JavaScript toolchain
How to get it
- 1
Install with a package manager
You'll need: Node.js
Clone the repository
git clone https://github.com/jxnblk/mdx-deck - 2
Run it
- Install Node.js on your machine
- Follow the setup instructions in the project README
- Create an MDX file with your slides separated by ---
- Start the local development server and open the deck in a browser
- 3
Get the most out of it
- Use React components directly inside slides for interactive content
- Keep slides in Markdown so content can be edited as plain text
- Check the README for theming and layout options before designing a custom look
Downloads
Strengths
- Uses familiar Markdown syntax together with React components
- Described as zero-config, so you can start without extensive setup
- MIT licensed and open source
Trade-offs
- Requires familiarity with React and MDX, which is a barrier for non-developers
- Last code push listed as January 2023, so maintenance activity may be limited; check the repository before relying on it
- No published release is listed, so you would install from the repository source
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| mdx-deck (this) | 11.5k | Dev tool | intermediate | 3.8 years ago | Developers who already write React and want to present technical material |
| spectacle | 10.2k | Library | intermediate | 10 days ago | React developers who want to build slides as code |
| reveal.js | 72.5k | Library | intermediate | 1 months ago | Developers who already write HTML, CSS, or JavaScript and want full control over slide design |
| slidev | 49.3k | Dev tool | beginner | 14 days ago | Developers who want to present code, technical talks, or architecture diagrams |
| nodeppt | 10.3k | Dev tool | intermediate | 5.8 years ago | Developers who prefer writing slides in Markdown over a visual editor |
| marp | 12.7k | Other | beginner | 3 months ago | People who prefer writing slides as Markdown text rather than in a visual editor |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.