What merging does to your files
Plain concatenation (cat *.md) leaves problems behind: files come out in the wrong order, every file's YAML front matter lands in the middle of the document, and a chapter that starts with ## sits under one that starts with #. This tool handles those cases before joining the files.
- Order: each batch of files you add is sorted by name in natural order, so 2 comes before 10. Drag, use the arrows, or press Sort by name at any time.
- Front matter: the --- (YAML) or +++ (TOML) block at the top of each file is removed. Choose Keep the first file's to put that one block back at the very top.
- Headings: Match levels shifts each file so its highest heading becomes H1 (or H2 under an added file title). Setext headings (underlined with === or ---) are rewritten as # headings when they move.
- Table of contents: built from the merged headings, with anchors that follow GitHub's rules, so the links work when the file is viewed on GitHub.