# MarpUI

> Self-hosted, open-source web app for authoring MARP markdown slide decks: Monaco editor, live preview, speaker notes, mermaid diagrams, and HTML/PDF/PPTX export.

- **Category:** [Notes & Editors](https://selfhost.directory/notes-editors)
- **Licence:** MIT
- **Source model:** Open source
- **Latest version:** 0.6.1
- **Author:** squarecows
- **Platforms:** NPM
- **Ports:** 3000 (HTTP port serving the web UI and Express API)
- **Requires:** Local browser (Chrome, Edge, or Firefox) (optional)
- **Tags:** Markdown, Mcp, Monaco Editor, Mermaid, Themes, Offline First, Slides, Presentations, Highlighting, Pdf export, Powerpoint

## What is MarpUI?

MarpUI is a single-user app, served from your own machine into a browser, for writing and showing slide decks in the MARP markdown format. Editing happens in a Monaco-based pane beside a live render of the current slide, with a thumbnail strip underneath for adding slides, drag-reordering them and jumping around. Presenting can run as a fullscreen slideshow in one window plus a presenter window in another — the two stay in sync over BroadcastChannel, and the presenter side shows speaker notes (written as HTML comments in the markdown), a preview of the next slide, and a timer you can pause or reset. Rendering handles Mermaid diagrams, GitHub-style callout blocks, footnotes, subscript and other extended markdown, and highlight.js code coloring. The official MARP themes ship included, custom CSS themes can be imported and edited live, and fonts or images dropped into a theme's or deck's folder are discovered automatically. Decks export to HTML, PDF or PPTX through @marp-team/marp-cli; for the latter two formats, a supported browser must be present on the machine. An opt-in Model Context Protocol server on /mcp exposes deck, theme, font and image tools to AI assistants such as Claude Desktop, and markdown-it plugins can be installed from npm without a restart. Assets are all bundled, so nothing is fetched from the network once installed. Setup is a global npm install that registers a desktop shortcut on macOS, Windows and Linux; the app then listens on port 3000 and keeps content under ~/Documents/MarpUI. It is MIT-licensed, still at 0.x versions, and aimed at one presenter — there is no user login or multi-user support.

## Should you self-host MarpUI?

MarpUI scores **51/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#42 of 83** in [Notes & Editors](https://selfhost.directory/notes-editors).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. It is MIT-licensed.

Its closest alternative on selfhost.directory is [Memos](https://selfhost.directory/project/memos) (85/100, 64 505 stars). It scores higher overall, so compare the two before you pick. [See MarpUI vs Memos side by side.](https://selfhost.directory/compare/marpui-vs-memos)

## Features

- Auto-save
- Custom themes
- Dual-screen presenter view
- Export to PDF / HTML / PPTX — PDF and PPTX export require a locally installed browser.
- Extended Markdown
- GitHub-style Alerts
- Keyboard Shortcuts
- Live slide preview
- MCP server for AI assistants (◐ partial) — Disabled by default; enable via Settings or MARP_MCP_ENABLED=1.
- Mermaid diagrams — Mermaid blocks may not appear in PDF/PPTX exports; a warning dialog appears.
- Offline First
- Overthrow? no — Content overflow detection
- Plugin Support
- Slide reordering
- Speaker Notes

## How to install MarpUI

### Install MarpUI with NPM

```bash
npm install -g marp-ui
```

Note: Creates a desktop shortcut (macOS app in /Applications, Windows Start Menu entry, Linux .desktop file); launch with `marp-ui` and the browser opens at http://localhost:3000.

## MarpUI alternatives

- [Slipshow](https://selfhost.directory/project/slipshow): Open-source presentation tool that compiles Markdown into self-hosted standalone HTML with scrolling slips, replayable hand drawings and speaker notes. (compare: https://selfhost.directory/compare/marpui-vs-slipshow)
- [marimo](https://selfhost.directory/project/marimo): marimo is an open-source, self-hosted reactive Python notebook replacing Jupyter and Streamlit. Stores notebooks as pure Python files with SQL, interactive UI, AI. (compare: https://selfhost.directory/compare/marimo-vs-marpui)
- [Bento](https://selfhost.directory/project/bento): Self-hosted, open-source PowerPoint alternative: each deck is a single HTML file containing its own viewer, editor, and E2EE live collaboration, working offline. (compare: https://selfhost.directory/compare/bento-vs-marpui)
- [mermaid-live-editor](https://selfhost.directory/project/mermaid-live-editor): Self-hosted, open-source web editor for Mermaid diagrams with live preview, SVG and PNG export, and shareable view or edit links. (compare: https://selfhost.directory/compare/marpui-vs-mermaid-live-editor)
- [presenton](https://selfhost.directory/project/presenton): Self-hosted, open-source AI presentation maker: generate decks from prompts or documents, export editable PPTX and PDF, BYOK or Ollama models, plus a REST API. (compare: https://selfhost.directory/compare/marpui-vs-presenton)
- [plumio](https://selfhost.directory/project/plumio): plumio is a self-hosted, open-source markdown note app with live preview, encryption, multi-user/org support, webhooks, API keys, and backups. (compare: https://selfhost.directory/compare/marpui-vs-plumio)
- [xEdit](https://selfhost.directory/project/xedit): xEdit is a self-hosted, open-source Markdown editor and lightweight Notion/Obsidian alternative with live preview, wiki links, and MCP for AI. (compare: https://selfhost.directory/compare/marpui-vs-xedit)
- [NoteDiscovery](https://selfhost.directory/project/notediscovery): Self-hosted, open-source Markdown knowledge base: wikilinks, backlinks, graph view, tags, templates, LaTeX, Mermaid, drawing editor, MCP AI access. One Docker container. (compare: https://selfhost.directory/compare/marpui-vs-notediscovery)

## More in Notes & Editors

- [memEx](https://selfhost.directory/project/memex-2): Self-hosted open-source knowledge base in the Zettelkasten and org-mode tradition: linked notes, contexts, pipelines, backlinks, multi-user sharing and per-item privacy.
- [memEx](https://selfhost.directory/project/memex): A structured personal knowledge base inspired by zettlekasten and org-mode, designed for notes, contexts, and pipelines with multi-user support and privacy controls.
- [Memos](https://selfhost.directory/project/memos): Self-hosted, open-source note app for Markdown memos with search, tags, calendar, and visibility controls. Runs as a single binary with SQLite/MySQL/PostgreSQL.
- [Memos Worker](https://selfhost.directory/project/memos-worker): Self-hosted notes and knowledge base on Cloudflare Workers with D1, KV, R2, featuring Markdown editing, full-text search, Telegram integration, and themes.
- [mininote](https://selfhost.directory/project/mininote): A self-hosted, open-source Markdown note-taking app with client-side AES-GCM encryption built with Vue 3 and Express, using LokiJS for storage.
- [minutes](https://selfhost.directory/project/minutes): Free, open-source app that records and transcribes meetings locally into Markdown, then lets AI assistants like Claude Code search the history via MCP.
- [moonstone](https://selfhost.directory/project/moonstone): Self-hosted headless PKM server turning Obsidian, Logseq, Zim vaults into a REST API with PWA editor, applets, and background services.
- [nanote](https://selfhost.directory/project/nanote): A self-hosted note-taking application that stores notes as markdown files on the filesystem for full portability, with Docker support and a mobile-friendly UI.
- [NarraLume](https://selfhost.directory/project/narralume): NarraLume is a self-hosted, open-source writing studio for novels with a story bible, versioned Markdown editing, optional AI drafting, and export.
- [Nextcloud Notes](https://selfhost.directory/project/nextcloud-notes): ✎ Distraction-free notes and writing
- [NoteDiscovery](https://selfhost.directory/project/notediscovery): Self-hosted, open-source Markdown knowledge base: wikilinks, backlinks, graph view, tags, templates, LaTeX, Mermaid, drawing editor, MCP AI access. One Docker container.
- [Note Mark](https://selfhost.directory/project/note-mark): Note Mark is a self-hosted, open-source Markdown notes app with responsive UI, GFM support, dark/light themes, note sharing, asset attachments, and OIDC SSO.

## Links

- [Homepage](https://codeberg.org/ric_harvey/marp-ui)

---
Source: https://selfhost.directory/project/marpui