{"id":13679554,"url":"https://github.com/remarkjs/remark-language-server","last_synced_at":"2025-06-10T21:19:22.028Z","repository":{"id":38348028,"uuid":"441117214","full_name":"remarkjs/remark-language-server","owner":"remarkjs","description":"A language server to lint and format markdown files with remark","archived":false,"fork":false,"pushed_at":"2024-07-28T10:28:02.000Z","size":27,"stargazers_count":41,"open_issues_count":0,"forks_count":1,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-05-29T05:55:00.272Z","etag":null,"topics":["language-server","lsp","remark"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/remarkjs.png","metadata":{"funding":{"github":"unifiedjs","open_collective":"unified"},"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-23T08:43:43.000Z","updated_at":"2025-04-12T00:44:51.000Z","dependencies_parsed_at":"2024-07-28T12:13:28.212Z","dependency_job_id":null,"html_url":"https://github.com/remarkjs/remark-language-server","commit_stats":{"total_commits":11,"total_committers":2,"mean_commits":5.5,"dds":"0.36363636363636365","last_synced_commit":"ae2d737c31e6386ec802052739e03b4830dfa025"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remarkjs%2Fremark-language-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remarkjs%2Fremark-language-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remarkjs%2Fremark-language-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remarkjs%2Fremark-language-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/remarkjs","download_url":"https://codeload.github.com/remarkjs/remark-language-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/remarkjs%2Fremark-language-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259152784,"owners_count":22813227,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["language-server","lsp","remark"],"created_at":"2024-08-02T13:01:06.851Z","updated_at":"2025-06-10T21:19:21.815Z","avatar_url":"https://github.com/remarkjs.png","language":"JavaScript","funding_links":["https://github.com/sponsors/unifiedjs","https://opencollective.com/unified"],"categories":["JavaScript"],"sub_categories":[],"readme":"# remark-language-server\n\n[![Build][build-badge]][build]\n[![Downloads][downloads-badge]][downloads]\n[![Sponsors][sponsors-badge]][collective]\n[![Backers][backers-badge]][collective]\n[![Chat][chat-badge]][chat]\n\nA language server to lint and format markdown files with **[remark][]**.\n\n## Contents\n\n* [What is this?](#what-is-this)\n* [When should I use this?](#when-should-i-use-this)\n* [Install](#install)\n* [Use](#use)\n  * [Configuration file](#configuration-file)\n  * [Settings](#settings)\n* [Examples](#examples)\n  * [Emacs](#emacs)\n  * [Neovim](#neovim)\n  * [vim-lsp](#vim-lsp)\n  * [Visual Studio Code](#visual-studio-code)\n* [Compatibility](#compatibility)\n* [Contribute](#contribute)\n* [License](#license)\n\n## What is this?\n\nThis package is a [language server][] which can lint and format markdown files\nusing remark.\n\n## When should I use this?\n\nYou can use this package when you want to enhance your editor with linting and\nformatting of markdown files.\nSome editors can consume this package directly, others need a plugin in order to\nconsume this package.\n\n## Install\n\nThis package is [ESM only][].\nIn Node.js (version 16.0+, or 18.0+), install with [npm][]:\n\n```sh\nnpm install remark-language-server\n```\n\n## Use\n\nUsage of this package depends on your editor integration.\nBecause this is based on\n[`unified-languageserver-node`][unified-languageserver-node], the same features\nare supported.\n\n### Configuration file\n\n`remark-language-server` uses the same configuration files as\n[`remark-cli`][remark-cli].\nThese files are:\n\n* `.remarkrc`\n* `.remarkrc.cjs`\n* `.remarkrc.js`\n* `.remarkrc.json`\n* `.remarkrc.mjs`\n* `.remarkrc.yaml`\n* `.remarkrc.yml`\n* `package.json`\n\nLanguage clients should notify the language server if these files change.\nThey are looked up starting at the folder where the checked markdown file\nexists.\n\n### Settings\n\nThis language server supports the following settings:\n\n* `remark.requireConfig` (`boolean`, default: `false`) — If true, only perform\n  actions if a [configuration file][configuration-file] is found.\n\n## Examples\n\n### Emacs\n\nUse [`lsp-mode`][lsp-mode] to use the remark language server with Emacs.\n\n### Neovim\n\nThe remark language server is part of [`nvim-lspconfig`][nvim-lspconfig], a\ncollection of common configurations for Neovim’s built-in language server\nclient.\nThis means you can add remark language server in one line:\n\n```lua\nrequire'lspconfig'.remark_ls.setup {\n  settings = {\n    remark = {\n      requireConfig = true\n    }\n  }\n}\n```\n\n`nvim-lspconfig` has\n[detailed installation instructions][nvim-lspconfig-instructions] such as\nconfiguration options.\n\n### vim-lsp\n\nThe remark language server can be used with [`vim-lsp`][vim-lsp].\nYou can configure it to be started when a markdown file is opened.\n\n```viml\nif (executable('remark-language-server'))\n  au User lsp_setup call lsp#register_server({\n  \\ 'name': 'remark',\n  \\ 'cmd': {server_info-\u003e['remark-language-server', '--stdio']},\n  \\ 'allowlist': ['markdown'],\n  \\ 'config': lsp_settings#get('remark-language-server', 'config', lsp_settings#server_config('remark-language-server')),\n  \\ 'workspace_config': lsp_settings#get('remark-language-server', 'workspace_config', {\n  \\   'requireConfig': v:true,\n  \\ }),\n  \\ })\nendif\n```\n\nOtherwise, if you use [`vim-lsp-settings`][vim-lsp-settings], you will be asked\nto use the remark language server automatically when a markdown file is opened.\n\n### Visual Studio Code\n\nUse [`vscode-remark`][vscode-remark] to use the remark language server with\nVisual Studio Code.\n\n## Compatibility\n\nProjects maintained by the unified collective are compatible with all maintained\nversions of Node.js.\nAs of now, that is Node.js 16.0+, and 18.0+.\nOur projects sometimes work with older versions, but this is not guaranteed.\n\n## Contribute\n\nSee [`contributing.md`][contributing] in [`remarkjs/.github`][health] for ways\nto get started.\nSee [`support.md`][support] for ways to get help.\nJoin us in [Discussions][chat] to chat with the community and contributors.\n\nThis project has a [code of conduct][coc].\nBy interacting with this repository, organization, or community you agree to\nabide by its terms.\n\n## License\n\n[MIT][license] © [Remco Haszing][author]\n\n\u003c!-- Definitions --\u003e\n\n[build-badge]: https://github.com/remarkjs/remark-language-server/workflows/main/badge.svg\n\n[build]: https://github.com/remarkjs/remark-language-server/actions\n\n[configuration-file]: #configuration-file\n\n[downloads-badge]: https://img.shields.io/npm/dm/remark-language-server.svg\n\n[downloads]: https://www.npmjs.com/package/remark-language-server\n\n[esm only]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c\n\n[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg\n\n[backers-badge]: https://opencollective.com/unified/backers/badge.svg\n\n[collective]: https://opencollective.com/unified\n\n[chat-badge]: https://img.shields.io/badge/chat-discussions-success.svg\n\n[chat]: https://github.com/remarkjs/remark/discussions\n\n[health]: https://github.com/remarkjs/.github\n\n[contributing]: https://github.com/remarkjs/.github/blob/main/contributing.md\n\n[lsp-mode]: https://github.com/emacs-lsp/lsp-mode\n\n[support]: https://github.com/remarkjs/.github/blob/main/support.md\n\n[coc]: https://github.com/remarkjs/.github/blob/main/code-of-conduct.md\n\n[license]: https://github.com/remarkjs/remark-language-server/blob/main/license\n\n[author]: https://github.com/remcohaszing\n\n[npm]: https://docs.npmjs.com/cli/install\n\n[nvim-lspconfig]: https://github.com/neovim/nvim-lspconfig\n\n[nvim-lspconfig-instructions]: https://github.com/neovim/nvim-lspconfig/blob/master/doc/server_configurations.md#remark_ls\n\n[language server]: https://microsoft.github.io/language-server-protocol/\n\n[remark]: https://github.com/remarkjs/remark\n\n[remark-cli]: https://github.com/remarkjs/remark/tree/main/packages/remark-cli\n\n[unified-languageserver-node]: https://github.com/unifiedjs/unified-language-server\n\n[vim-lsp]: https://github.com/prabirshrestha/vim-lsp\n\n[vim-lsp-settings]: https://github.com/mattn/vim-lsp-settings\n\n[vscode-remark]: https://github.com/remarkjs/vscode-remark\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremarkjs%2Fremark-language-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fremarkjs%2Fremark-language-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremarkjs%2Fremark-language-server/lists"}