mdpls: Markdown Preview Language Server
July 21, 2022 ยท View on GitHub
Markdown, please!
mdpls is a language server that provides a live HTML preview of your markdown in your browser.
mdpls is powered by aurelius, which also powers vim-markdown-composer.
Installation
mdpls requires stable Rust, which can easily be installed and updated via rustup.
cargo install --git https://github.com/euclio/mdpls
The mdpls binary will be installed to .cargo/bin in your home directory.
Usage
mdpls works with your favorite editor's LSP plugin. Consult your plugin's documentation for information on how to configure a new language server.
Like most language servers, mdpls operates over stdin and stdout.
Configuration
| Setting | Type | Description | Default |
|---|---|---|---|
markdown.preview.auto | boolean | Open the markdown preview automatically. | true |
markdown.preview.browser | array or string | The program and arguments to use for opening the preview window. If not specified, the user's default browser will be used. The preview URL will be appended to this program as an argument. | None |
markdown.preview.codeTheme | string | highlight.js style to use for syntax highlighting in code blocks. | github |
markdown.preview.serveStatic | boolean | Serve static files like images (this should only be use with trusted documents) | false |
markdown.preview.renderer | array or string | The program to use to render the markdown to html. If not specified, the builtin markdown renderer will be used. | None |
Commands
The language server also provides commands for interacting with the browser preview.
| Command | Description |
|---|---|
Open Preview | Opens the markdown preview. |