#language-server #markdown #grammar #lsp #document

app prosemd-lsp

An experimental proofreading and linting language server for markdown files

1 unstable release

0.1.0 Mar 12, 2021

#94 in #lsp

LGPL-2.1

7.5MB
58K SLoC

C 35K SLoC C++ 22K SLoC // 0.0% comments Rust 732 SLoC // 0.0% comments

prosemd

prosemd is an experimental proofreading and linting language server for markdown files. It aims to provide helpful and smart diagnostics when writing prose for technical or non-technical documents alike.

Under the hood, it integrates with any editor supporting the Language Server Protocol, and uses nlprule, which is based on LanguageTool, to highlight possible errors and provides suggestions on how to address them.

Note: On the roadmap for more features are other useful linting rules, related to Markdown links, formatting, and other potentially helpful features, however for now prosemd is limited to just grammar & style correction with nlprule and only supports English.

Quick Start

Setup in VSCode

If you're using VSCode, all you have to do is install the prosemd extension.

Read more about the VSCode extension.

Manual Installation

If you're setting the language server up with your editor of choice then you'll need to either download the executable or compile it from source:

  • Download the latest release executable for your OS (Either: prosemd-lsp-linux, prosemd-lsp-windows.exe, or prosemd-lsp-macos).
  • or; install Rust and then run cargo install prosemd-lsp to compile prosemd from source.

Configuring coc.nvim

First, make sure that you install the prosemd-lsp executable.

You may add prosemd to coc.nvim's config manually in coc-settings.json opened by the :CocConfig command, like so:

{
  "languageserver": {
    "prosemd": {
      "command": "/usr/local/bin/prosemd-lsp",
      "args": ["--stdio"],
      "filetypes": ["markdown"],
      "trace.server": "verbose",
      "settings": {
        "validate": true
      }
    }
  }
}

Don't forget to swap out the binary's path at command to where you've installed the prosemd-lsp executable.

Configuring nvim-lspconfig

First, make sure that you install the prosemd-lsp executable.

You may add prosemd to Neovim's built-in language server client by adding it to nvim-lspconfig's list of language servers:

local lsp_configs = require('lspconfig/configs')

lsp_configs.prosemd = {
  default_config = {
    -- Update the path to prosemd-lsp
    cmd = { "/usr/local/bin/prosemd-lsp", "--stdio" },
    filetypes = { "markdown" },
    root_dir = function(fname)
      return lsp_util.find_git_ancestor(fname) or vim.fn.getcwd()
    end,
    settings = {},
  }
}

-- Use your attach function here
local lsp = require('lspconfig')
lsp.prosemd.setup{ on_attach = on_attach }

Don't forget to swap out the binary's path at cmd to where you've installed the prosemd-lsp executable.

Dependencies

~24–41MB
~673K SLoC