📝

【マークダウン】Multiple top-level headings in the same documentを解決する

2022/11/19に公開約500字

問題発生の背景

Zenn CLIが良いらしいということで実際に使って見たときに発生しました。
メッセージ内容は、「1つのファイルにh1は1つまでだよ」みたいな注意をされています。
波線出て気になる
波線出て気になる

Zennにデプロイされると2行目のtitleがh1として変換されるので11行目のh1と被ってるということです。
しかし、ZennのUI的にh1の方が見やすいのでh1を複数使いたいです。

結論

ディレクトリの一番上の階層に.markdownblint.jsonを作成して設定すると解決できます。

.markdownlint.json
{
  "MD025": false
}

keyは記法ルール、valuebooleanで設定できます。

波線消えました
波線消えました

参考記事

記法ルールの一覧とか載ってます。
https://github.com/DavidAnson/vscode-markdownlint

Discussion

ログインするとコメントできます