Marp Guide: Code Your Next Slide Deck in Markdown

How to Build Markdown Slides Instantly with Marp Creating presentation slides often feels like a chore. Dragging text boxes, aligning icons, and fighting with complex formatting tools takes time away from what actually matters: your content.

If you already write notes or documentation in Markdown, there is a much faster way. Marp (Markdown Advanced Presentation Ecosystem) allows you to convert plain text files into professional, beautifully styled slide decks instantly.

Here is how to get started with Marp and build your first deck in minutes. Why Use Marp?

Focus on content: Write text without worrying about layout alignment.

Version control friendly: Track your slides using Git just like source code.

Fast execution: Build, edit, and update presentations in seconds.

Developer-ready: Built-in syntax highlighting for code blocks.

Multiple formats: Export easily to PDF, HTML, or PowerPoint (PPTX). Setting Up Your Environment

The easiest way to use Marp is through Visual Studio Code (VS Code). Open VS Code.

Go to the Extensions Marketplace (Ctrl+Shift+X or Cmd+Shift+X). Search for Marp for VS Code and click Install.

Once installed, you gain access to a real-time side-by-side preview of your slides as you type. Writing Your First Slide Deck

Create a new file named presentation.md. To tell Marp to treat this Markdown file as a presentation, you must start the file with a front-matter configuration block. Copy and paste this basic template:

— marp: true theme: default paginate: true class: lead — # How to Build Markdown Slides Instantly with Marp By Your Name An easier way to present. — ## What is Marp? Marp is a Markdown-based presentation ecosystem. - Write text in plain Markdown. - Automatically format layout and typography. - Export to PDF, HTML, or PPTX. — ## Adding Images and Layouts You can include visuals easily: -Split Screens:** Use background tags. - Easy Alignment: Keep text clean. - Dynamic Content: Images scale automatically. Use code with caution. Core Concepts to Master 1. The Front Matter

If you want to style just one specific slide (like making the title page look different), use the underscore prefix () before a directive: _class: lead centers the text on that specific slide. _background: #f5f5f5 changes the color of just that slide. 4. Background Images and Split Layouts Marp uses extended Markdown syntax for advanced imaging. sets a full-bleed background image.

splits the slide, placing the image on the left side taking up 40% of the width, while your text automatically flows into the remaining 60%. Exporting Your Slides When your deck is ready, exporting it takes two clicks:

Click the Marp icon (a small blue icon with a stylized “M”) that appears in the top-right corner of your VS Code editor menu bar.