A markdown linter for Bear

Francesco Puppo

BearのためのMarkdownリンター

原文は Francesco Puppo により に公開されました。 このブログを購読する

Bearは数あるMarkdownアプリの中でも、とびきり美しい――いや、最も美しいと言ってもいいアプリです。機能はあえて絞り込まれており、だからこそチームはこれほど洗練されたアプリを作り上げられているのです。

でも、Markdownはすぐに散らかってしまいます。空行が何行も続いたり、見出しの階層がぐちゃぐちゃになったり、スマートクォートが統一されていなかったり。普通の人なら気にしないような細かい一貫性の問題ですが、僕にはとことん気になってしまうのです。

オンラインにはMarkdownリンターはたくさんありますが、Bearのノートデータベースに直接対応しているものは一つもありませんでした。

Bear CLIとClaude Codeが登場した今、自分で解決することにしました。

bear-lintは、新しくリリースされたBear CLIを使って、ターミナルからBearのノートを1件でも複数でもまとめてMarkdownを修正できるツールです。1

単一のノートをリントするには、bear-lint <note-id>と入力します…

単一のノートをリントするbear-lintのスクリーンショット

…すべてのノートをリントするには、bear-lint --allを使います。

すべてのノートをリントするbear-lintのスクリーンショット

同じハッシュタグが付いたノートをまとめてリントしたい場合は、bear-lint --all "#tag"を使います。

ノートに手を加えずに差分だけ確認したい場合は、-n/--dry-runを付けてください。

実行しても、スクリプトはファイルの更新日時を変更しません。そのため、ノートの並び順はそのまま保たれます。

変更内容をまとめたサマリーノートをBear内に作成したい場合は、-oを付けてください。#bear-lintタグ付きで、変更点の一覧が記録されます。

サマリーノートのスクリーンショット

このツールはノートに直接書き込むものなので、公開前に自分のライブラリで何度もテストを重ねました。ちゃんとしたテストスイートも用意しており、2回連続で実行しても互いの変更を取り消したり二重に適用したりしないことも確認しています。それでも何かおかしな点があれば、ぜひ教えてください。

GitHubでチェックしてみてください!

脚注

  1. そのため、Bear 2.8以降が必要です

この記事は「muse-spark-1.2-contributor」を使用して翻訳されました。

コメント