Merge a Docs Folder Into a Single Markdown File
Select every file in a docs folder, order them, and join them into one document with filename headings so each source stays identifiable.
Direct answer
In Merge mode, use the file picker to select all the .md files in the folder at once, or drag the whole selection onto the drop zone. Reorder them to match the reading order of your docs, choose the filename-heading separator, then download the combined file. The heading keeps the origin of each section visible, which matters when a merged handbook is later reviewed.
Open Merge & Split Markdown toolWhen to use this
- You want a printable or shareable single-file version of a docs site.
- An AI assistant should read the whole documentation set in one paste.
- You are archiving a project and want one file instead of a folder.
Steps
- Open the Merge tab.
- Select every .md file in the folder in the file picker.
- Reorder the list so the introduction comes first.
- Choose the filename heading separator, at H1 or H2 level.
- Press Download to save the combined file.
Example conversion
01-intro.md, 02-install.md, 03-config.md, 04-faq.md
# 01-intro ... # 02-install ... # 03-config ... # 04-faq ...
Common mistakes
- Numbered filenames sort predictably; unnumbered ones do not. Rename files before selecting them if the order matters and you do not want to reorder by hand.
- Nested folders are not walked. A file picker selection is flat, so pick the files you want from each folder.
- Front matter blocks from a static site generator are copied as-is and will appear mid-document. Strip them first if the merged file is for human reading.
FAQ
- Can I select a folder instead of files?
- The tool takes a multi-file selection, not a folder walk. Open the folder in the picker and select all the files inside it.
- Does the merge keep the original files?
- Yes. Nothing on disk is modified. The tool only reads the files and builds a new combined document for download.
- What separator should I choose?
- A filename heading when readers need to know where each section came from; a horizontal rule for a clean read; nothing when the files are already parts of one continuous document.
Related merge and split guides
How to Combine Multiple Markdown Files Into One
Select several .md files, put them in the order you want, and join them with a horizontal rule or a filename heading between each one. Everything runs in the browser.
How to Split a Long Markdown Document by Heading
Paste one large Markdown document, choose H1 or H2 as the break point, and get one part per section with its own copy and download button.
Chunk a Markdown File for AI Context Windows
Split a long document into size-limited parts so each chunk fits a model context window or a RAG index entry. Size is set in characters, with an approximate token count shown.
Split a Book Manuscript Into Chapter Files
A manuscript that uses one H1 per chapter can be split into one file per chapter, each downloadable on its own.