Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Markdownlint

ebullientebullient6k downloads

Use markdownlint to make the contents of your files more consistent.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates15

This plugin uses the markdownlint library to lint files in your vault.

This plugin supports a subset of files supported by markdownlint-cli2. Specifically .markdownlint.jsonc, .markdownlint.json, .markdownlint.yaml, or .markdownlint.yml.[^1]

[^1]: Other formats require interpretation or use parsers that don't work well as an Obsidian plugin, in my experience. If you have a favorite format beyond these few, I welcome your help in making it work. Otherwise, it is what it is.

Installation

Preview with Beta Reviewers Auto-update Tester (BRAT)

  1. Install BRAT
    1. Open Settings -> Community Plugins
    2. Disable safe mode
    3. Browse, and search for "BRAT"
    4. Install the latest version of Obsidian 42 - BRAT
  2. Open BRAT settings (Settings -> Obsidian 42 - BRAT)
    1. Scroll to the Beta Plugin List section
    2. Add Beta Plugin
    3. Specify this repository: ebullient/obsidian-markdownlint
  3. Enable the plugin (Settings -> Community Plugins)

Using the plugin

If one of the supported config files (listed above) is present, markdown files will be linted with markdownlint following the configured rules.

Issues with your file will be highlighted in the editor for you to fix as you go.

HealthExcellent
ReviewSatisfactory
About
Lint Markdown files in your vault with markdownlint and highlight issues directly in the editor. Apply rules from .markdownlint.json, .markdownlint.jsonc, .markdownlint.yaml, or .markdownlint.yml configuration files and fix problems as you edit.
MarkdownFormattingEditing
Details
Current version
1.0.7
Last updated
4 weeks ago
Created
2 years ago
Updates
15 releases
Downloads
6k
Compatible with
Obsidian 1.12.0+
Platforms
Desktop only
License
MIT
Report bugRequest featureReport plugin
Sponsor
Buy Me a Coffee
Author
ebullientebullient
github.com/ebullient
GitHubebullient
  1. Community
  2. Plugins
  3. Markdown
  4. Markdownlint

Related plugins

Linter

Format and style your notes. Linter can be used to format YAML tags, aliases, arrays, and metadata; footnotes; headings; spacing; math blocks; regular Markdown contents like list, italics, and bold styles; and more with the use of custom rule options.

Editing Toolbar

The Editing Toolbar is modified from cMenu, which provides more powerful customization settings and has many built-in editing commands to be a MS Word-like toolbar editing experience.

Outliner

Work with your lists like in Workflowy or Roam Research.

Image Captions

Add captions to images with inline Markdown and link support. The caption format is compatible with the Commonmark spec and other Markdown applications.

Sort and Permute lines

Sort and Permute lines in whole file or selection.

Various Complements

Complete words similar to auto-completion in an IDE.

Heading Shifter

Easily Shift and Change Markdown headings.

PanGu

Add spaces between Chinese characters and English alphabet. A boon for typographically compulsive people.

Shortcuts extender

Use shortcuts for input special symbols without language switching.

Chord Sheets

Work with chord sheets (chords over lyrics or inline) in Live Preview and reading mode: Chord diagrams for guitar, ukulele, mandolin and piano, transpose, autoscroll, and more.