Split large markdown documents into `##`-based section files with index.md.
npx skills add https://github.com/curdx/curdx-flow --skill bmad-shard-doc-curdx
Please help me install this Agent Skill. Skill: bmad-shard-doc Source: https://github.com/curdx/curdx-flow/tree/main/.agents/skills/bmad-shard-doc Command: npx skills add https://github.com/curdx/curdx-flow --skill bmad-shard-doc-curdx
Large markdown files become hard to navigate, review, and reuse, so this Skill turns one bulky document into smaller, section-based files that are easier to manage and reference.
## headings (default behavior).npx @kayvan/markdown-tree-parser explode to create the shard structure and an index.md entry.Use the bmad-shard-doc Skill to shard your file /path/to/architecture.md into /path/to/architecture/.
High-intent search queries and answers about installing and using this skill.
Splitting a large markdown file into smaller section files is done by sharding it based on `##` headings. This process creates an `index.md` entry and organized fragments to reduce navigation friction and make documentation maintenance easier.
The best way to break down a markdown knowledge base for incremental updates is by sharding documents into structured `##`-based fragments. This allows you to manage and reuse individual sections without reviewing a bulky file.
Markdown sharding includes options to delete, archive, or keep the original file after creating the new section files. This flexibility prevents duplicated source-of-truth confusion when you split your document.
Sharding markdown documents using the CLI involves executing `npx @kayvan/markdown-tree-parser explode` with verified input and output paths. This deterministic tooling execution generates an organized shard structure in your destination directory.
You need to shard a markdown file when it becomes hard to navigate, review, and reuse. Splitting one bulky document into smaller section-based files makes maintaining and referencing your documentation significantly easier.
ncptuanSplit large Markdown documents into section-based files by level 2 headings.
edneyreis999Navigate index.md files to identify minimal document sections for reading.
dt418Build documentation platforms with versioned docs, search, navigation, code highlighting, and API reference generation.
bitfasterSplit BenchmarkDotNet assembly markdown files into per-method files.