shell - Markdown ファイルを特定のコード スタイルに再フォーマットする

Question

私は数人の人がテキストを書き編集している本に取り組んでいます。すべてマークダウンです。残念ながら、さまざまなスタイルと線幅が混在しています。技術的にはこれは問題ではありませんが、美学の点では良くありません。

これらのファイルを GitHub マークダウン スタイルなどで再フォーマットする最善の方法は何ですか? このジョブ用のシェル スクリプトはありますか?

Answer 1

Pandocを見たいと思うかもしれません。Markdown のいくつかのフレーバーを理解します。

pandoc -f markdown -t gfm foobar.md

何年も前に Perl でマークアップ コンバーターを作成した経験があるので、適切な字句解析ツールを使用せずにこのようなタスクに取り組みたくはありません。これは、シェル スクリプトを少し超えるものです。

Answer 2

このスタイルガイドに従って任意の Markdown (GFM を含む) を再フォーマットするtidy- markdownというツールを作成しました。

$ tidy-markdown < ./ugly-markdown.md > ./clean-markdown.md

インライン HTML から Markdown への変換、コード ブロックなどの構文要素の正規化 (fenced への変換)、リスト、ブロック引用符、front-matter、ヘッダーを処理し、コード ブロック言語識別子の標準化も試みます。