Skip to main content

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 | bash

See 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 login

3.Build

With @marp-team/marp-cli installed locally, render your Markdown to a static HTML file:

marp slides.md --html --output build/index.html

Want 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-deck

5.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-deck

Re-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-deck

Other frameworks

Same five steps work for the other supported slide frameworks.