Hello everyone,

This might be a problem only for me, but I hate when markdown gets messy and notes are inconsistent.

Online there are plenty of markdown linters, but none of them works with Bear’s notes database.

Since Bear CLI and Claude Code are now a thing, I decided to solve this for myself.

bear-lint checks and fixes common Markdown inconsistencies in your notes, straight from the terminal. Needs Bear 2.8+ for Bear CLI.

A few examples:

bear-lint <note-id> lints a single note.
bear-lint --all lints every note (asks for confirmation first).
bear-lint --all "#tag" lints every note under a given hashtag.
bear-lint <note-id> -n shows a diff of what would change without touching anything.
bear-lint --all -o also saves a summary note in Bear, tagged #bear-lint, listing everything that changed.

Writes use bearcli’s --no-update-modified flag, so your notes keep their original modified date and don’t reorder in your list.

Since this writes straight to your notes, I’ve run it against my own library multiple times before releasing it, and there’s now a test suite behind it too. If it gets something wrong, let me know, issues are welcome on GitHub.

Download it here 👉 github.com/i-am-fran/bear-lint

Screenshots

Linting a single note

Linting all your notes

Summary note in Bear

Let me know what you think!