Get mdserve on macOS and Linux Now!
Installed with a shell one-liner. Open source, with a documented setup.
Get mdserve with one command
Pick your system, reveal the step-by-step guide, copy the command, paste it into your terminal and press Enter. This command was taken from the project's own documentation and checked against it.
Not available for Windows yet.
mdserve doesn't publish an install command for Windows anywhere we can verify, so there's nothing for us to show you. We won't invent one. It does document one for macOS and Linux — switch to that tab.
Pastes into PowerShell and installs mdserve on your Windows machine in one step. Runs as your normal user account, and needs no administrator rights.
Not available for macOS yet.
mdserve doesn't publish an install command for macOS or Linux anywhere we can verify, so there's nothing for us to show you. We won't invent one.
Pastes into your terminal and installs mdserve on your macOS or Linux machine in one step — no manual setup, no build tools. It fetches the project's own install script and runs it, which is the standard way these tools ship — worth a read if you like to know what's running.
How to set up mdserve, step by step
Open Terminal. On a Mac it's in Applications ▸ Utilities, or press Cmd+Space and type Terminal. On Linux, press Ctrl+Alt+T. Paste the command and press Enter.
Run mdserve --help to see the available commands, and
mdserve --version to confirm the install worked. If your shell complains about
permissions, that project usually documents a corrected command on its own site.
This downloads the project's shell installer and pipes it straight into your shell, which executes it without saving a file. Same caveat: it's the project's script, but read it first if you want to be sure.
What mdserve does
- Not a static site server or something you deploy to production
- Not a general-purpose markdown authoring tool with heavy customization
- Scans and serves all and files in that directory
- Displays a navigation sidebar for easy switching between files
- Watches for new markdown files added to the directory
- Only monitors the immediate directory (non-recursive)
Summarised from mdserve's own README.
About mdserve
Installed with a shell one-liner. Open source, with a documented setup.
| Category | Developer tool |
|---|---|
| Install method | shell one-liner (curl | bash) |
| Windows | no install command published |
| macOS / Linux | documented install command available |
| Price | Free and open source |
| Command verified | Yes — checked against the project README |
| Popularity | 422 stars on the project's public repository |
On mobile
mdserve is a command-line tool, so there is no phone app for it — a phone has no shell to run it in. You'll need a desktop, or a remote shell into a machine that has one.
mdserve is developed by its own authors. This page is an independent reference; we are not affiliated with or sponsored by the project. The command shown here was reproduced from the project's public documentation — always check the project's own documentation before running anything.