312bf8c7bf8b6a9a1bf78eb1788a4b3caee67620
Complete implementation of md-explode command for transforming single markdown files into organized directory structures: Core Implementation: - MarkdownSection class for hierarchical document modeling - extract_headings() - Parse markdown headings with levels - parse_markdown_structure() - Build section hierarchy from content - generate_safe_filename() - Convert headings to filesystem-safe names - explode_markdown_file() - Main explosion functionality - DirectoryStructureBuilder - Create organized file/directory structures CLI Integration: - md-explode command with comprehensive options - --dry-run for previewing structure - --verbose for detailed output - --max-depth for limiting nesting - --output-dir for custom output location Key Features: - Hierarchical structure preservation (# → ## → ###) - Smart filename generation with Unicode support - Front matter handling and preservation - Content integrity maintenance - Cross-platform filesystem compatibility - Comprehensive error handling and validation Refactoring Applied: - Eliminated code duplication between filename functions - Extracted front matter processing into dedicated function - Modularized CLI command with helper functions - Improved error handling and user feedback Documentation: - Complete API documentation with docstrings - Comprehensive user documentation (docs/md-explode-command.md) - Usage examples and troubleshooting guide - Integration instructions with other MarkiTect commands Testing: 47 comprehensive tests covering all functionality Status: Production-ready, full TDD8 cycle completed Performance: Efficient for documents with thousands of sections 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
MarkiTect - Advanced Markdown Engine
Your Markdown, Redefined.
MarkiTect transforms markdown from plain text into intelligent, structured data with performance optimization, schema validation, and relational querying capabilities. Stop treating documentation as text files—start managing it as a database.
Key Features:
- Lightning Performance: 60-85% faster document processing through intelligent AST caching
- Schema Validation: Enforce document structure and consistency
- Database Integration: Query markdown content with SQL-like operations
- CLI Tools: Complete command-line interface for automation and workflows
📚 Documentation
Quick Start: Getting Started · Command Reference
Architecture: Caching System · Performance Philosophy
Development: TDD Workflow · Contributing
Project Status: Current Status · Roadmap · Next Actions
Description
Releases
1
MarkiTect 0.8.0
Latest
Languages
Python
84.7%
JavaScript
8%
HTML
5.6%
Makefile
1.3%
Shell
0.2%
Other
0.1%