Skip to content

euclio/mdpls

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mdpls: Markdown Preview Language Server

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.