{"id":77181,"date":"2026-06-23T09:39:16","date_gmt":"2026-06-23T09:39:16","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=77181"},"modified":"2026-06-23T09:39:20","modified_gmt":"2026-06-23T09:39:20","slug":"complete-marp-installation-command-examples-guide","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/complete-marp-installation-command-examples-guide\/","title":{"rendered":"Complete Marp installation + command + examples guide"},"content":{"rendered":"\n

Marp is a Markdown presentation ecosystem. Marp CLI converts Marp\/Marpit Markdown files into static HTML\/CSS, PDF, PowerPoint\/PPTX, and images<\/strong>. The official CLI docs also say Node.js v18+<\/strong> is required for the Node-based CLI, and PDF\/PPTX\/image conversion requires a browser such as Chrome, Edge, or Firefox. (GitHub<\/a>)<\/p>\n\n\n\n

\n\n\n\n

1. What Marp is best for<\/h1>\n\n\n\n

Marp is best when you want:<\/p>\n\n\n

Markdown \u2192 HTML\nMarkdown \u2192 PDF\nMarkdown \u2192 PPTX\nMarkdown \u2192 PNG\/JPEG images\n<\/code><\/span><\/pre>\n\n\n
For you, Marp is excellent for:<\/p>\n\n\n
quick training decks\nclient PPTX\/PDF\nsimple course slides\nfast Markdown-based slide generation\nGit-based slide maintenance\n<\/code><\/span><\/pre>\n\n\n
But remember:<\/p>\n\n\n
Marp HTML is Marp HTML, not reveal.js HTML.\nFor<\/span> reveal.js, use<\/span> Quarto<\/span>.\nFor<\/span> quick<\/span> PPTX<\/span>\/PDF<\/span>, Marp<\/span> is<\/span> very<\/span> strong<\/span>.\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
2. Your current file<\/h1>\n\n\n\n
You already have this file:<\/p>\n\n\n
cd ~\/slides\nls\n<\/code><\/span><\/pre>\n\n
Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.marp<\/span>.md<\/span>\nIntroduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.qmd<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
For Marp, we will use:<\/p>\n\n\n
Introduction_to_Red_Hat_OpenShift_DevOpsSchool<\/span>.marp<\/span>.md<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
3. Install Marp on macOS<\/h1>\n\n\n\n
Option A: Use Homebrew<\/h2>\n\n\n\n
This is the cleanest option on macOS:<\/p>\n\n\n
brew install marp-cli\n<\/code><\/span><\/pre>\n\n\n
Check:<\/p>\n\n\n
marp --version\nwhich marp\n<\/code><\/span><\/pre>\n\n\n
The official Marp CLI README lists Homebrew as a macOS\/Linux package-manager install option, though it notes package manifests are community-maintained. (GitHub<\/a>)<\/p>\n\n\n\n
\n\n\n\n
Option B: Use Node.js and npm<\/h2>\n\n\n\n
Install Node.js:<\/p>\n\n\n
brew install node\n<\/code><\/span><\/pre>\n\n\n
Check:<\/p>\n\n\n
node --version\nnpm --version\n<\/code><\/span><\/pre>\n\n\n
Install Marp CLI globally:<\/p>\n\n\n
npm<\/span> install<\/span> -g<\/span> @marp-team<\/span>\/marp-cli\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Check:<\/p>\n\n\n
marp --version\n<\/code><\/span><\/pre>\n\n\n
If marp<\/code> command does not work, use:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli --version\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
Option C: Use npx<\/code> without global install<\/h2>\n\n\n\n
This is the easiest when PATH is causing issues:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli@latest<\/span> --version\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Convert HTML:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli@latest<\/span> slide-deck.md\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Convert PDF:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli@latest<\/span> slide-deck.md --pdf\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
Convert PPTX:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli@latest<\/span> slide-deck.md --pptx\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
4. Install Marp on Windows<\/h1>\n\n\n\n
Option A: Node.js + npm<\/h2>\n\n\n\n
Install Node.js LTS from the official Node.js site.<\/p>\n\n\n\n
Then open PowerShell:<\/p>\n\n\n
node<\/span> --version<\/span>\nnpm<\/span> --version<\/span>\nnpm<\/span> install<\/span> -g<\/span> @marp-team<\/span>\/marp-cli\nmarp --version\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
If command is not found:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli --version\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
Option B: Scoop<\/h2>\n\n\n\n
The official Marp CLI README lists Scoop as the Windows package-manager install option:<\/p>\n\n\n
scoop install marp\n<\/code><\/span><\/pre>\n\n\n
Then:<\/p>\n\n\n
marp --version\n<\/code><\/span><\/pre>\n\n\n
(GitHub<\/a>)<\/p>\n\n\n\n
\n\n\n\n
Option C: VS Code extension<\/h2>\n\n\n\n
Install Marp for VS Code<\/strong>.<\/p>\n\n\n\n
In VS Code:<\/p>\n\n\n
Extensions \u2192 Search \u201cMarp for VS Code\u201d \u2192 Install\n<\/code><\/span><\/pre>\n\n\n
The VS Code extension integrates Marp CLI export and supports exporting active Markdown to HTML, PDF, PPTX, PNG, JPEG, and TXT notes. It also requires a browser for PDF\/PPTX\/image export. (Visual Studio Marketplace<\/a>)<\/p>\n\n\n\n
\n\n\n\n
5. Install Marp on Linux<\/h1>\n\n\n\n
Option A: Node.js + npm<\/h2>\n\n\n
node<\/span> --version<\/span>\nnpm<\/span> --version<\/span>\nnpm<\/span> install<\/span> -g<\/span> @marp-team<\/span>\/marp-cli\nmarp --version\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
If Node.js is old, install Node.js v18+ first.<\/p>\n\n\n\n
\n\n\n\n
Option B: Homebrew on Linux<\/h2>\n\n\n
brew install marp-cli\nmarp --version\n<\/code><\/span><\/pre>\n\n\n
\n\n\n\n
Option C: Docker<\/h2>\n\n\n\n
Marp provides an official container image. The official README lists Docker images from Docker Hub and GitHub Container Registry. (GitHub<\/a>)<\/p>\n\n\n\n
Pull:<\/p>\n\n\n
docker pull marpteam\/marp-cli\n<\/code><\/span><\/pre>\n\n\n
or:<\/p>\n\n\n
docker pull ghcr.io\/marp-team\/marp-cli\n<\/code><\/span><\/pre>\n\n\n
Example usage:<\/p>\n\n\n
docker run --rm -v \"$PWD:\/home\/marp\/app\"<\/span> marpteam\/marp-cli slide-deck.md\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
PDF:<\/p>\n\n\n
docker run --rm -v \"$PWD:\/home\/marp\/app\"<\/span> marpteam\/marp-cli slide-deck.md --pdf\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
PPTX:<\/p>\n\n\n
docker run --rm -v \"$PWD:\/home\/marp\/app\"<\/span> marpteam\/marp-cli slide-deck.md --pptx\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
6. Verify Marp installation<\/h1>\n\n\n\n
Run:<\/p>\n\n\n
marp --version\n<\/code><\/span><\/pre>\n\n\n
Expected style:<\/p>\n\n\n
@marp-team<\/span>\/marp-cli v4.x.x (w\/ @marp-team\/marp-core v4.x.x)\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
If that fails:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli --version\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
7. Fix: zsh: command not found: marp<\/code><\/h1>\n\n\n\n
You saw this issue earlier:<\/p>\n\n\n
marp --version\nzsh: command not found: marp\n<\/code><\/span><\/pre>\n\n\n
But this worked:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli --version\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
That means Marp is installed, but the global npm binary path is not in your PATH<\/code>.<\/p>\n\n\n\n
Step 1: Check npm global prefix<\/h2>\n\n\n
npm config get<\/span> prefix\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Example:<\/p>\n\n\n
\/opt\/homebrew\/Cellar\/node\/26.3.1\n<\/code><\/span><\/pre>\n\n\n
Step 2: Check Marp binary<\/h2>\n\n\n
ls -l \"$(npm config get prefix)\/bin\/marp\"<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Step 3: Add npm global bin path to zsh<\/h2>\n\n\n
echo<\/span> 'export PATH=\"$(npm config get prefix)\/bin:$PATH\"'<\/span> >> ~\/.zshrc\nsource ~\/.zshrc\nrehash\nmarp --version\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Step 4: If still not working, add exact path<\/h2>\n\n\n\n
Based on your earlier output:<\/p>\n\n\n
echo<\/span> 'export PATH=\"\/opt\/homebrew\/Cellar\/node\/26.3.1\/bin:$PATH\"'<\/span> >> ~\/.zshrc\nsource ~\/.zshrc\nrehash\nmarp --version\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Step 5: Stronger symlink fix<\/h2>\n\n\n
ln -sf \/opt\/homebrew\/Cellar\/node\/26.3.1\/bin\/marp \/opt\/homebrew\/bin\/marp\nrehash\nwhich marp\nmarp --version\n<\/code><\/span><\/pre>\n\n\n
For daily work, this is always safe:<\/p>\n\n\n
npx<\/span> @marp-team<\/span>\/marp-cli --version\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
8. Create your first Marp slide deck<\/h1>\n\n\n\n
Create folder:<\/p>\n\n\n
mkdir -p ~\/slides\/m<\/span>arp-test\/images\ncd ~\/slides\/m<\/span>arp-test\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Create file:<\/p>\n\n\n
cat > openshift-intro.marp.md <<'EOF'<\/span>\n---\nmarp: true<\/span>\ntheme: default<\/span>\npaginate: true<\/span>\nfooter: \"DevOpsSchool\"<\/span>\n---\n\n# Introduction to Red Hat OpenShift<\/span>\n\n## DevOpsSchool Training<\/span>\n\n---\n\n# What is OpenShift?<\/span>\n\nRed Hat OpenShift is an enterprise Kubernetes platform.\n\nIt helps teams build, deploy, run, and<\/span> manage containerized applications.\n\n---\n\n# Why OpenShift?<\/span>\n\n- Enterprise Kubernetes\n- Built-in security\n- Developer experience\n- Integrated CI\/CD\n- Operators\n- Monitoring\n\n---\n\n# Example Commands<\/span>\n\n```bash\noc login\noc get projects\noc get pods -A\noc get routes -A\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
Summary<\/h1>\n\n\n\n
The official CLI docs show marp --version<\/code> as the way to confirm the CLI and engine version. (GitHub<\/a>)<\/p>\n\n\n\n
Note: --preview<\/code> is not available through the official Docker image. (GitHub<\/a>)<\/p>\n\n\n\n
The official docs call npx<\/code> a good way to run latest Marp CLI for one-shot conversion without installing the command globally. (GitHub<\/a>)<\/p>\n\n\n\n
The official docs list both local installation using npm install --save-dev @marp-team\/marp-cli<\/code> and global installation using npm install -g @marp-team\/marp-cli<\/code>. (GitHub<\/a>)<\/p>\n\n\n\n