Marp Presentation Setup

This guide explains how to install Marp and build your presentation from a Markdown file.

Prerequisites

You need Node.js and npm installed on your system. If you don't have them:

Install Node.js and npm

Option 1: Using nvm (Recommended for users without admin rights)

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Restart your terminal or run:
source ~/.bashrc  # or source ~/.zshrc for zsh

# Install Node.js (includes npm)
nvm install node

Option 2: Download from nodejs.org

Visit nodejs.org and download the installer for your operating system.

Project Setup

Install Packages necessary, Marp CLI

npm install .

This installs Marp locally in your project (not globally).

Building Your Presentation

Build PDF (default)

npm run build

Watch Mode (auto-rebuild on changes)

npm run watch

Troubleshooting

Permission errors with npm install

If you get permission errors, configure npm to use a user directory:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Add the export line to your ~/.bashrc or ~/.zshrc file.

Images not showing in PDF

Use the --allow-local-files flag:

npm run build

Additional Resources

• Marp Documentation
• Marp CLI GitHub
• Markdown Guide