Markdown linters and formatters

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

mdformat

• GitHub
  • Development stalled, last commit/tag 2023-08
• Supports plugins
  • Without the mdformat-gfm plugin, Markdown checkboxes will get re-formatted wrongly
• nvim/mason support
  • For proper GFM support, don't use Mason until mdformat-gfm gets bundled in Mason 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
  • Doesn't walk up the directory tree to find a config file like markdownlint-cli
    • (No) 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
  • config format
  • Rules
    • Inline disabling of rules
• pre-commit support

Other linters / formatters

• markdownlint/markdownlint
  • Ruby, last git tag 2023-10
• markdown-toc API and CLI for generating a markdown TOC (table of contents) for a README or any markdown files