bmad-shard-doc

To split a large markdown document into smaller sections, this Skill automates the process by dividing the file based on level 2 headings. It allows you to specify a destination folder and manage the original document after splitting.

Document sharding for markdown files is the process of breaking down large documents into smaller, organized files. This makes technical documentation and content guides easier to navigate and maintain over time.

Yes, you need npx and the @kayvan/markdown-tree-parser package to execute the markdown sharding process. These dependencies are required to parse the document structure and automate the file splitting.

Yes, you can choose the destination folder when dividing a markdown document. The process supports user input for the destination path and allows you to decide what to do with the original document after sharding.

The best way to organize large technical documentation in markdown is to shard the file into smaller sections using level 2 headings. This creates manageable files that are easier to navigate and maintain for developers.

Markdown sharding uses level 2 headings to ensure consistent document structure and logical content division. This approach automatically creates organized sections based on the main topics defined by the document's second-level headers.