gaia-shard-doc

You can split Markdown documents by sectioning the file at a chosen heading level, which creates individual shard files alongside an index.md that links to each shard for easy navigation.

Partitioning long-form technical docs by H2 headings is the default behavior, generating named shard files for each section while preserving the original document structure and content intact.

Yes, you can split Markdown files at H1 or H3 heading levels by overriding the default setting using the level configuration option to match your document's specific hierarchy.

Content before the first split-level heading becomes a dedicated preamble.md file, ensuring introductory text is preserved separately while the main sections become individual shards.

When sharding a Markdown file with zero headings, the process emits a clear message and does not create any shards or output directories to prevent empty file generation.

Yes, the tool asks for user confirmation before writing the shard files, though it supports automatically proceeding in YOLO or non-interactive mode for automated documentation workflows.