bmad-shard-doc

To split a large Markdown document into smaller files by section, provide the source file path and destination folder. The tool parses level 2 headings to generate an index.md and navigable shard files for modular documentation.

Yes, you can automate breaking down long manuals into modular Markdown files by running npx @kayvan/markdown-tree-parser explode with a source file and destination folder, which organizes content by level 2 headings with validation and error handling.

No external dependencies are required to run this Markdown sharding tool. It operates by executing the npx @kayvan/markdown-tree-parser package directly, handling the source file explosion and index generation without needing a separate installation step.

The best way to organize a large knowledge base using Markdown is to shard the content into an index and directory of files based on level 2 headings. This creates a navigable structure ideal for modular documentation projects.

After sharding, the split Markdown files are organized into a directory of individual section files based on level 2 headings, accompanied by a generated index.md file to provide easy navigation and maintenance for the documentation.

If the source Markdown file encounters validation errors during sharding, the process includes built-in error handling to manage the failure. This ensures the npx markdown-tree-parser explode command executes safely without corrupting the destination folder.