Markdown結合

長い文書が一つのファイルのままでいることは少ない。本は章ごとに分かれ、書き出しツールは節ごとにファイルを作り、変換作業のあとにはフォルダいっぱいの断片が残る。二十個のファイルを横断して検索したり、入力を一つしか取らない道具に渡したりするには、まず繋ぐ必要がある。

並べた順に連結され、各部分の前には元のファイル名を書いたコメントが、後ろには区切り線が入る。途中で書き換えはしない。見出しの階層はそのままなので、二つの章がどちらも最上位から始まっていればそのまま残るし、重複したタイトルもまとめられない。Markdownとテキストのファイルは混ぜられる。二つ以上のファイルが必要だ。

目次も重複検出もない。出力が予測でき、あとから手で直しやすいことを優先しているためだ。繋ぐ相手がPDF変換から出てきた断片なら、ページ番号のコメントも結合後にそのまま残る。