Quickstart · Marp
Sharing Marp decks
Marp turns Markdown into slide decks using @marp-team/marp-cli. This guide walks you from a local .md file to a public share URL in five steps.
1.Install the CLI
The linkdown Rust binary publishes a single install script. Pipe it to bash:
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
One-time login opens your browser and pairs the CLI with your account via OAuth2 device flow. The token is stored in your OS keychain.
linkdown login3.Build the deck
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.Get a share URL
The CLI prints the share link on success. If you closed the terminal, generate it again:
linkdown share my-marp-deckAdd --expiry 30d or --password secret to scope the link.
Updating an existing deck
When you change the source, rebuild and re-upload. The share URL from step 5 is preserved so existing viewers keep working (per PR #117):
linkdown update ./build --name my-marp-deckOther frameworks
Same five steps work for the other supported slide frameworks.