Split Markdown

Split a .md file into separate files at each heading.

Split one Markdown file into separate files at each heading

A single Markdown file can grow into something unwieldy: a long guide with a dozen sections, or notes that started small and turned into a reference document nobody wants to scroll through anymore. This tool breaks one file into several smaller ones, cutting at each heading so every piece stands on its own.

You upload the .md file and choose the option labeled Split at heading level, with a choice of 1, 2, or 3; the default of 2 breaks the file wherever a second-level heading appears, which usually lines up with the main sections of a document. Each resulting piece keeps its own heading and the text under it, and you get them all at once in a single zip file rather than one long file to sort through by hand.

Only one file can be split at a time, so if you have several long documents you will run this once per file. Processing happens on the site's servers over a secure connection, and everything you upload is removed within sixty minutes. If your document has headings nested more deeply than the level you choose, those subsections stay attached to the piece they belong under.

Once you have the smaller files, Merge Markdown can put a different subset back together. Splitting is free on a daily allowance, and works from a browser on any device.

How to use the Split Markdown tool

  1. Add your MD, MARKDOWN file: drag & drop or click to browse.
  2. Set your options: Split at heading level.
  3. Click “Process Split Markdown” and download your result.

Common questions

Is Split Markdown free?

Yes. Split Markdown is free for light use with no signup needed. Anonymous visitors get 10 free tasks per day, and creating a free account makes daily use unlimited. A paid Pro plan removes ads and raises file-size limits for heavier work.

Is my file safe?

Yes. Your file is sent over HTTPS, processed by self-hosted open-source software on our servers (no third-party AI or cloud APIs), and deleted within 60 minutes at the latest, usually right after your result is ready.

What file formats does Split Markdown accept?

Split Markdown accepts MD, MARKDOWN files. Convert other formats to a supported one first; the related tools below can usually do it.

Related tools

Browse all 110+ free PDF, Markdown, JSON and image tools →

Markdown version of this page (plain text, for AI agents and automation)