Skip to main content

Quickstart ยท Slidev

Sharing Slidev decks

Slidev is a Vue-powered, Markdown-first slide framework aimed at developer presentations. This guide takes you from a local slides.md to a public share URL in five steps.

1.Install the CLI

The linkdown Rust binary installs from a single script. Pipe it to bash:

curl -fsSL https://lnkdwn.com/install.sh | bash

Need to inspect it first? The script is at /install.sh. Manual install options are in the CLI reference.

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 login

3.Build the deck

From the root of your Slidev project, run the built-in static export. Output lands in dist/:

npx slidev build

Make sure slidev is in your package.json devDependencies โ€” the CLI uses that to auto-detect the framework.

4.Upload

The CLI auto-detects Slidev from slidev in your package.json. The default build directory is ./dist:

linkdown create ./dist --name my-slidev-deck

Want to skip auto-detection? Pass --framework slidev explicitly.

5.Get a share URL

The CLI prints the share link on success. If you closed the terminal, generate it again:

linkdown share my-slidev-deck

Add --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 ./dist --name my-slidev-deck

Other frameworks

Same five steps work for the other supported slide frameworks.