shard-doc

To split a large markdown document, this skill automatically shards it into smaller files based on level 2 headings. It creates a directory structure for the sharded files and generates an index file for easy navigation.

Yes, markdown sharding preserves all original content formatting, code blocks, and diagrams. The splitting process ensures that markdown elements remain intact within the newly created section files.

The best way to organize lengthy technical specification markdown files is by sharding them into a logical folder hierarchy. This process breaks documents into manageable section files for easier team navigation.

Yes, you can manually parse markdown headings as an alternative to the automated md-tree command. The skill supports both automated sharding and a manual parsing process with robust error handling and validation.

Yes, you need the markdown-tree-parser dependency to shard documents into a folder structure. This package enables the automated parsing of level 2 headings required for the file splitting process.

You should not use automated document sharding when your markdown content lacks level 2 headings or requires maintaining a single-file structure. The skill specifically splits documents based on level 2 heading boundaries.