Markdown linters and formatters

rumdl

• GitHub
• Docs
• Markdownlint Migration
• Inline configuration
• nvim-lspconfig rumdl config
• pre-commit-hook

Issues

• Neovim LSP doesn't auto-format
• feature request: rumdl markdown formatter support

Prettier

• coding/quality/linting.md
• Default Lazyvim markdown formatter
• also formats markdown code
• Plugins
  • Slidev prettier plugin
  • markdown-code-fences
    • Doesn't work: TypeError: prettierMarkdown.parsers.markdown.preprocess is not a function

hukkin/mdformat

• GitHub
• Python
• Supports plugins
  • Without the mdformat-gfm plugin, Markdown checkboxes will get re-formatted wrongly
• For proper GFM support, don't use Mason until mdformat-gfm gets bundled in Mason is installed and install the mdformat and mdformat-gfm-git system-wise

Install:

  sudo pacman -S mdformat
  pamac install mdformat-gfm-git

Issues:

• No Options to disable/enable rules
• FR: Configure default language for fenced code blocks
• mdformat reformats --- to _______, destroying slide seperators
  • Installng mdformat-frontmatter will only fix this for the frontmatter, but not for slide seperators

DavidAnson/markdownlint-cli2

• GitHub
• NodeJS, based on the NodeJS DavidAnson/markdownlint library
• AUR package: markdownlint-cli2
• David Ansons Blog: Why markdownlint-cli2 ?
• Default linter installed by LayzVim markdown extra
• Configuration
  • Looks for a config file in the current directory and all parent directories until one is found, but doesn't merge them like markdownlint-cli does
    • see also Support configuration file in parent directory of CWD
  • Inline disabling of rules
• pre-commit support

Igorshubovych/markdownlint-cli

• GitHub
• NodeJS, based on the NodeJS DavidAnson/markdownlint library
• AUR package: markdownlint-cli
• Configuration
  • Config files: markdownlint-cli looks for these files in the current directory:
    • .markdownlint.jsonc
    • .markdownlint.json
    • .markdownlint.yaml
    • .markdownlint.yml
    • or for the file .markdownlintrc in the current or all parent folders and merges them (markdownlint-cli2 doesn't merge them)
      • Beware: .markdownlintrc needs to be valid JSON (or INI), comments in the JSON file will lead to markdownlint silently ignoring it!!
  • config format
  • Rules
    • Inline disabling of rules
• pre-commit support

Other linters / formatters

• markdown-toc API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files

Stale:

• Kunde21/markdownfmt
  • Last release 2023
• shurcooL/markdownfmt
  • Last release 2014
• tidy-markdown
  • Last release 2016
• moorereason/mdfmt
  • Last commit 2018
• markdownlint/markdownlint
  • Ruby, last git tag 2023-10