Quickstart ยท Marp
Sharing Marp decks with linkdown
Five steps from your source folder to a shareable link.
Your share URL survives edits
Fix a typo, rebuild, run linkdown update. The same URL keeps working โ no broken embeds, no fresh links to paste.
1.Install the CLI
Install the linkdown CLI:
curl -fsSL https://lnkdwn.com/install.sh | bashSee the CLI reference for manual install from source, or grab /install.sh to inspect it.
2.Authenticate
linkdown login opens your browser to confirm the device.
linkdown login3.Build
With @marp-team/marp-cli installed locally, render your Markdown to a static HTML file:
marp slides.md --html --output build/index.htmlWant a PDF or PPTX instead? See marp-cli usage. Any single-file output in build/ is fine.
4.Upload
The CLI auto-detects Marp from @marp-team/marp-cli in yourpackage.json, a .marp/ config, or _mp*.md files. Pass --name to set a display name:
linkdown create ./build --name my-marp-deck5.Share
Your deck is live at the URL printed in the terminal. The link survives edits โ see the call-out above.
linkdown share my-marp-deckRe-print the link any time with linkdown share <name>. Add --expiry 30d or --password secret to scope the link.
Updating an existing deck
Run linkdown update after edits. The share URL is preserved.
linkdown update ./build --name my-marp-deckOther frameworks
Same five steps work for the other supported slide frameworks.