mintlify-convert 2.0.0__tar.gz

mintlify_convert-2.0.0/CHANGELOG.md

@@ -0,0 +1,94 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+No release has been tagged or published yet. The entries below describe the v2.0 work in progress.
+
+### Added
+- Mintlify component output: Warning, Note, Tip, Info and Check callouts, Steps, Tabs, Cards, Accordion (keyword heuristic on H3 titles), Banner (narrow prefix match) and Frame-wrapped images
+- Navigation generation with nested groups from the folder structure; "Getting Started" first, then alphabetical; optional `--sort-pages`
+- `docs.json` generation (`--generate-config`) and legacy `mint.json` generation (`--legacy-mint-json`)
+- Asset handling: images are copied only with `--download-assets` and only from inside the input directory
+- MDX validation with error reporting
+- Command-line interface with branding options for the generated config file
+- Project restructure into a package, test suite with fixtures, examples, CI workflows and pre-commit configuration
+
+### Changed
+- `--generate-mint-json` is deprecated; it is an alias for `--generate-config --legacy-mint-json`
+- Minimum supported Python version is 3.10
+- Conversion is idempotent, and the output path may not equal or sit inside the input path
+- Input files larger than 1 MiB are rejected with an error
+- Navigation groups are ordered "Getting Started", then "Documentation", then the rest alphabetically
+- Accordions are created only for H3 headings containing troubleshooting, FAQ, frequently asked, advanced, common issues, known issues, error codes, walkthrough, step by step or breakdown, and end at the next heading of any level
+- One numbered list becomes one `<Steps>` block; it continues across blank lines and code fences or indented content between items
+- Step titles are plain text and end at a clause or word boundary at about 80 characters
+- Consecutive language-labelled blocks (three or more included) form one `<Tabs>` group
+- Relative links that resolve outside the input directory are left unchanged
+- Callouts, banners and step lists that start with a code fence are left unconverted; banners and help cards only match at the start of a paragraph
+- Symlinked input files and `file:` image sources are skipped with a warning on stderr; the exit status stays 0
+- `--validate` no longer reports code-block content as unclosed tags
+
+### Security
+- Images are copied only with `--download-assets`, only from inside the input directory, and only if they are common image types; absolute, `file:`, `data:` and `//` sources and symlinks are not copied, and copied files keep only their base name
+- The output path may not equal or sit inside the input path
+- Input files over 1 MiB are rejected, symlinked input files are skipped, and link and image patterns are length-bounded
+
+### Removed
+- `--use-ai-description` flag and the placeholder AI description code (AI descriptions are future work)
+- Legacy standalone script `mintlify_convert.py`
+- Documentation of flags that never existed (`--no-validate`, `--parallel`, `--workers`, `--no-download-assets`) and of environment variables and exit codes the code does not implement
+
+### Fixed
+- Pathological input no longer causes slow conversion: 20,000 consecutive `Python:` label lines and 100,000 repeated `[a](` sequences each convert in under a second in a local run
+- A page whose first prose line is a tab label no longer uses it as the description
+- Broken links between documentation pages and placeholder URLs in the README and guides
+
+## Earlier history (dates unverified; carried over from the original file)
+
+The repository contains a single commit (2025-10-13). The release dates and the v1.x history below could not be verified and are kept as originally written, except for the two lines noted under 2.0.0.
+
+### [2.0.0] - 2024-01-01
+
+#### Added
+- Enhanced Mintlify component support (Accordion, Tabs, Banner, Callout)
+- Advanced navigation generation with nested groups
+- Asset handling and image copying
+- MDX validation with detailed error reporting
+- ~~AI description generation (placeholder for OpenAI integration)~~ Not implemented; the placeholder was removed (see Unreleased)
+- Comprehensive command-line interface
+- Custom branding options for mint.json
+- ~~Parallel processing support (future feature)~~ Not implemented; never available
+
+#### Changed
+- Complete rewrite from v1.x
+- Improved component mapping accuracy
+- Enhanced error handling and validation
+- Better support for complex documentation structures
+
+#### Fixed
+- Unclosed tag detection in MDX validation
+- Image path resolution issues
+- Navigation structure generation
+- Component conversion edge cases
+
+### [1.0.0] - 2023-12-01
+
+#### Added
+- Initial release
+- Basic MDX to Mintlify conversion
+- Core component mapping (Callouts, Steps, Cards)
+- Simple navigation generation
+- Command-line interface
+- Basic validation
+
+#### Features
+- Convert blockquotes to Callout components
+- Transform numbered lists to Steps
+- Generate help sections as Cards
+- Create basic mint.json files
+- Process single files and directories

mintlify_convert-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Mintlify Convert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mintlify_convert-2.0.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+recursive-include tests *.py *.mdx
+global-exclude __pycache__ *.py[cod]

mintlify_convert-2.0.0/PKG-INFO

@@ -0,0 +1,299 @@
+Metadata-Version: 2.4
+Name: mintlify-convert
+Version: 2.0.0
+Summary: Convert MDX documentation to Mintlify format
+Author-email: olamide_codex <oluwamusiwaolamide@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Olamideod/mintlify-convert
+Project-URL: Repository, https://github.com/Olamideod/mintlify-convert.git
+Project-URL: Issues, https://github.com/Olamideod/mintlify-convert/issues
+Keywords: mintlify,mdx,documentation,conversion,migration
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=3.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: jsonschema>=4; extra == "dev"
+Dynamic: license-file
+
+# Mintlify Convert
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Convert MDX documentation to Mintlify format with enhanced features for seamless migration.
+
+## ✨ Features
+
+### 🎯 Core Conversions
+- ✅ Frontmatter generation (title, description, icon, mode)
+- ✅ Callouts/Admonitions → Proper Mintlify components (`<Warning>`, `<Tip>`, `<Note>`, `<Info>`, `<Check>`)
+- ✅ Numbered lists → one `<Steps>` per list, with plain-text titles taken from each step
+- ✅ Help sections → `<Card>` components with contextual icons
+- ✅ API links → Mintlify API reference format
+- ✅ Code blocks with proper formatting
+
+### 🧩 Advanced Components (Enhanced with Technical Writing Rules)
+- ✅ `<Accordion>` for H3 sections whose titles match a keyword heuristic (troubleshooting, FAQ, advanced, common issues, known issues, error codes, walkthrough, step by step, breakdown)
+- ✅ `<Tabs>` and `<Tab>` for language-labelled code blocks, with display names such as "JavaScript"
+- ✅ `<Banner>` for paragraphs that start with "Deprecated:", "Important:", "Notice:" or "Alert:"
+- ✅ `<Frame>` around images that are copied with `--download-assets`
+
+### 🧭 Navigation
+- ✅ `docs.json` generation (default), or legacy `mint.json` with `--legacy-mint-json`
+- ✅ Nested groups based on folder structure ("Getting Started" first, then "Documentation", then A-Z)
+- ✅ Proper page titles from frontmatter
+- ✅ Optional alphabetical sorting
+
+### 🖼️ Asset Handling
+- ✅ Image copying to `/images` directory (only with `--download-assets`, only from inside the input directory)
+- ✅ Relative link rewriting (links that resolve outside the input directory are left unchanged)
+- ✅ Automatic path correction
+
+### 🔧 Quality Assurance
+- ✅ Input files over 1 MiB are rejected; symlinked inputs and `file:` images are skipped with a warning on stderr
+- ✅ MDX validation (unclosed or mismatched tags; code blocks are ignored)
+- ✅ Detailed error reporting
+- ✅ Verbose mode for debugging
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# From source (Python 3.10 or newer)
+git clone https://github.com/Olamideod/mintlify-convert.git
+cd mintlify-convert
+pip install -e .
+```
+
+The package is not yet published to PyPI.
+
+### Basic Usage
+
+```bash
+# Convert a single file
+mintlify-convert input.mdx -o output.mdx
+
+# Convert an entire directory
+mintlify-convert docs/ -o mintlify-docs/
+
+# With all features
+mintlify-convert docs/ -o mintlify-docs/ \
+  --generate-config \
+  --download-assets \
+  --validate \
+  --sort-pages
+```
+
+`--generate-config` writes `docs.json`. Add `--legacy-mint-json` to write `mint.json` instead. `--generate-mint-json` is a deprecated alias for both flags together.
+
+Converting is idempotent: running the tool on its own output produces the same output. The output path must not be the same as, or inside, the input path.
+
+## 📖 Documentation
+
+- **[Getting Started](docs/getting-started.mdx)** - Quick start guide
+- **[API Reference](docs/api-reference.mdx)** - Complete CLI and programmatic API
+- **[Component Mapping](docs/component-mapping.mdx)** - How patterns are converted
+- **[Troubleshooting](docs/troubleshooting.mdx)** - Common issues and solutions
+
+## 🎯 Component Conversions
+
+### Callouts (Enhanced)
+**Input:**
+```markdown
+> **Warning:** This is a critical note.
+> Please read carefully.
+```
+
+**Output:**
+```mdx
+<Warning>
+**Warning:** This is a critical note.
+Please read carefully.
+</Warning>
+```
+
+### Steps (Enhanced with Smart Titles)
+**Input:**
+```markdown
+1. Install dependencies using npm
+2. Configure your environment variables
+3. Start the development server
+```
+
+**Output:**
+```mdx
+<Steps>
+  <Step title="Install dependencies using npm">
+  Install dependencies using npm
+  </Step>
+  <Step title="Configure your environment variables">
+  Configure your environment variables
+  </Step>
+  <Step title="Start the development server">
+  Start the development server
+  </Step>
+</Steps>
+```
+
+### Tabs (Enhanced Language Support)
+**Input:**
+```markdown
+JavaScript:
+const api = require('api');
+
+Python:
+import api
+```
+
+**Output:**
+````mdx
+<Tabs>
+  <Tab title="JavaScript">
+```javascript
+const api = require('api');
+```
+  </Tab>
+  <Tab title="Python">
+```python
+import api
+```
+  </Tab>
+</Tabs>
+````
+
+##  Development
+
+### Setup
+```bash
+git clone https://github.com/Olamideod/mintlify-convert.git
+cd mintlify-convert
+pip install -e ".[dev]"
+```
+
+### Run Tests
+```bash
+pytest tests/ -v --cov=mintlify_convert
+```
+
+### Run Mintlify Convert
+```bash
+# Convert all MDX files in docs/ and write docs.json
+python -m mintlify_convert.cli docs/ -o mintlify-docs/ --generate-config
+
+# Convert a single file
+python -m mintlify_convert.cli doc.mdx -o output.mdx
+```
+
+### Conversion behaviour
+The converter follows the component guidance in [agent.md](agent.md):
+
+- Callouts become `<Warning>`, `<Tip>`, `<Note>`, `<Info>` or `<Check>`
+- Numbered lists become `<Steps>` with descriptive titles taken from each step
+- Accordions, Banners and Frames follow the narrow rules listed under Features
+- Callouts, banners and numbered lists that start with a code fence are left unconverted; banners and help cards only match at the start of a paragraph
+- Three or more consecutive language-labelled blocks form one `<Tabs>` group
+- Code fences are left untouched
+
+### Code Formatting
+```bash
+black mintlify_convert/
+flake8 mintlify_convert/
+mypy mintlify_convert/
+```
+
+##  Project Structure
+
+```
+mintlify-convert/
+├── mintlify_convert/           # Main package
+│   ├── __init__.py            # Package initialization
+│   ├── cli.py                 # Command-line interface
+│   ├── converter.py           # Core conversion logic
+│   ├── navigation.py          # docs.json / mint.json generation
+│   └── utils.py               # Helper utilities
+│
+├── tests/                      # Test suite
+│   ├── test_converter.py      # Unit tests for converter
+│   ├── test_integration.py    # Integration tests
+│   ├── test_navigation.py     # Navigation tests
+│   └── fixtures/              # Test fixtures
+│
+├── examples/                   # Example conversions
+│   ├── basic/                 # Basic examples
+│   ├── advanced/              # Advanced examples
+│   └── full-migration/        # Complete migration example
+│
+├── docs/                       # Package documentation
+│   ├── getting-started.mdx
+│   ├── api-reference.mdx
+│   ├── component-mapping.mdx
+│   └── troubleshooting.mdx
+│
+├── .github/
+│   └── workflows/             # CI/CD workflows
+│
+├── pyproject.toml             # Modern Python project config
+├── requirements.txt           # Dependencies
+├── requirements-dev.txt       # Development dependencies
+├── README.md                  # This file
+├── LICENSE                    # MIT License
+├── CHANGELOG.md              # Version history
+├── agent.md                   # Mintlify technical writing rules
+└── .gitignore                # Git ignore rules
+```
+
+## 🗺️ Roadmap
+
+### Future work
+- [ ] AI-powered description generation (not implemented)
+- [ ] Parallel processing for large docs (not implemented)
+- [ ] Interactive migration wizard (TUI)
+- [ ] Incremental conversion (only changed files)
+- [ ] Custom component plugins
+- [ ] Automatic image optimization
+- [ ] Diff viewer for conversions
+- [ ] VS Code extension
+- [ ] Web-based converter UI
+- [ ] Support for Docusaurus → Mintlify
+- [ ] Support for GitBook → Mintlify
+- [ ] Migration analytics and reporting
+
+## 🤝 Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Support
+
+- Issues: [GitHub Issues](https://github.com/Olamideod/mintlify-convert/issues)
+
+## 🙏 Acknowledgments
+
+Built with ❤️ to help teams migrate to Mintlify faster.
+
+*Star ⭐ this repo if it helped you!*

mintlify_convert-2.0.0/README.md

@@ -0,0 +1,266 @@
+# Mintlify Convert
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Convert MDX documentation to Mintlify format with enhanced features for seamless migration.
+
+## ✨ Features
+
+### 🎯 Core Conversions
+- ✅ Frontmatter generation (title, description, icon, mode)
+- ✅ Callouts/Admonitions → Proper Mintlify components (`<Warning>`, `<Tip>`, `<Note>`, `<Info>`, `<Check>`)
+- ✅ Numbered lists → one `<Steps>` per list, with plain-text titles taken from each step
+- ✅ Help sections → `<Card>` components with contextual icons
+- ✅ API links → Mintlify API reference format
+- ✅ Code blocks with proper formatting
+
+### 🧩 Advanced Components (Enhanced with Technical Writing Rules)
+- ✅ `<Accordion>` for H3 sections whose titles match a keyword heuristic (troubleshooting, FAQ, advanced, common issues, known issues, error codes, walkthrough, step by step, breakdown)
+- ✅ `<Tabs>` and `<Tab>` for language-labelled code blocks, with display names such as "JavaScript"
+- ✅ `<Banner>` for paragraphs that start with "Deprecated:", "Important:", "Notice:" or "Alert:"
+- ✅ `<Frame>` around images that are copied with `--download-assets`
+
+### 🧭 Navigation
+- ✅ `docs.json` generation (default), or legacy `mint.json` with `--legacy-mint-json`
+- ✅ Nested groups based on folder structure ("Getting Started" first, then "Documentation", then A-Z)
+- ✅ Proper page titles from frontmatter
+- ✅ Optional alphabetical sorting
+
+### 🖼️ Asset Handling
+- ✅ Image copying to `/images` directory (only with `--download-assets`, only from inside the input directory)
+- ✅ Relative link rewriting (links that resolve outside the input directory are left unchanged)
+- ✅ Automatic path correction
+
+### 🔧 Quality Assurance
+- ✅ Input files over 1 MiB are rejected; symlinked inputs and `file:` images are skipped with a warning on stderr
+- ✅ MDX validation (unclosed or mismatched tags; code blocks are ignored)
+- ✅ Detailed error reporting
+- ✅ Verbose mode for debugging
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# From source (Python 3.10 or newer)
+git clone https://github.com/Olamideod/mintlify-convert.git
+cd mintlify-convert
+pip install -e .
+```
+
+The package is not yet published to PyPI.
+
+### Basic Usage
+
+```bash
+# Convert a single file
+mintlify-convert input.mdx -o output.mdx
+
+# Convert an entire directory
+mintlify-convert docs/ -o mintlify-docs/
+
+# With all features
+mintlify-convert docs/ -o mintlify-docs/ \
+  --generate-config \
+  --download-assets \
+  --validate \
+  --sort-pages
+```
+
+`--generate-config` writes `docs.json`. Add `--legacy-mint-json` to write `mint.json` instead. `--generate-mint-json` is a deprecated alias for both flags together.
+
+Converting is idempotent: running the tool on its own output produces the same output. The output path must not be the same as, or inside, the input path.
+
+## 📖 Documentation
+
+- **[Getting Started](docs/getting-started.mdx)** - Quick start guide
+- **[API Reference](docs/api-reference.mdx)** - Complete CLI and programmatic API
+- **[Component Mapping](docs/component-mapping.mdx)** - How patterns are converted
+- **[Troubleshooting](docs/troubleshooting.mdx)** - Common issues and solutions
+
+## 🎯 Component Conversions
+
+### Callouts (Enhanced)
+**Input:**
+```markdown
+> **Warning:** This is a critical note.
+> Please read carefully.
+```
+
+**Output:**
+```mdx
+<Warning>
+**Warning:** This is a critical note.
+Please read carefully.
+</Warning>
+```
+
+### Steps (Enhanced with Smart Titles)
+**Input:**
+```markdown
+1. Install dependencies using npm
+2. Configure your environment variables
+3. Start the development server
+```
+
+**Output:**
+```mdx
+<Steps>
+  <Step title="Install dependencies using npm">
+  Install dependencies using npm
+  </Step>
+  <Step title="Configure your environment variables">
+  Configure your environment variables
+  </Step>
+  <Step title="Start the development server">
+  Start the development server
+  </Step>
+</Steps>
+```
+
+### Tabs (Enhanced Language Support)
+**Input:**
+```markdown
+JavaScript:
+const api = require('api');
+
+Python:
+import api
+```
+
+**Output:**
+````mdx
+<Tabs>
+  <Tab title="JavaScript">
+```javascript
+const api = require('api');
+```
+  </Tab>
+  <Tab title="Python">
+```python
+import api
+```
+  </Tab>
+</Tabs>
+````
+
+##  Development
+
+### Setup
+```bash
+git clone https://github.com/Olamideod/mintlify-convert.git
+cd mintlify-convert
+pip install -e ".[dev]"
+```
+
+### Run Tests
+```bash
+pytest tests/ -v --cov=mintlify_convert
+```
+
+### Run Mintlify Convert
+```bash
+# Convert all MDX files in docs/ and write docs.json
+python -m mintlify_convert.cli docs/ -o mintlify-docs/ --generate-config
+
+# Convert a single file
+python -m mintlify_convert.cli doc.mdx -o output.mdx
+```
+
+### Conversion behaviour
+The converter follows the component guidance in [agent.md](agent.md):
+
+- Callouts become `<Warning>`, `<Tip>`, `<Note>`, `<Info>` or `<Check>`
+- Numbered lists become `<Steps>` with descriptive titles taken from each step
+- Accordions, Banners and Frames follow the narrow rules listed under Features
+- Callouts, banners and numbered lists that start with a code fence are left unconverted; banners and help cards only match at the start of a paragraph
+- Three or more consecutive language-labelled blocks form one `<Tabs>` group
+- Code fences are left untouched
+
+### Code Formatting
+```bash
+black mintlify_convert/
+flake8 mintlify_convert/
+mypy mintlify_convert/
+```
+
+##  Project Structure
+
+```
+mintlify-convert/
+├── mintlify_convert/           # Main package
+│   ├── __init__.py            # Package initialization
+│   ├── cli.py                 # Command-line interface
+│   ├── converter.py           # Core conversion logic
+│   ├── navigation.py          # docs.json / mint.json generation
+│   └── utils.py               # Helper utilities
+│
+├── tests/                      # Test suite
+│   ├── test_converter.py      # Unit tests for converter
+│   ├── test_integration.py    # Integration tests
+│   ├── test_navigation.py     # Navigation tests
+│   └── fixtures/              # Test fixtures
+│
+├── examples/                   # Example conversions
+│   ├── basic/                 # Basic examples
+│   ├── advanced/              # Advanced examples
+│   └── full-migration/        # Complete migration example
+│
+├── docs/                       # Package documentation
+│   ├── getting-started.mdx
+│   ├── api-reference.mdx
+│   ├── component-mapping.mdx
+│   └── troubleshooting.mdx
+│
+├── .github/
+│   └── workflows/             # CI/CD workflows
+│
+├── pyproject.toml             # Modern Python project config
+├── requirements.txt           # Dependencies
+├── requirements-dev.txt       # Development dependencies
+├── README.md                  # This file
+├── LICENSE                    # MIT License
+├── CHANGELOG.md              # Version history
+├── agent.md                   # Mintlify technical writing rules
+└── .gitignore                # Git ignore rules
+```
+
+## 🗺️ Roadmap
+
+### Future work
+- [ ] AI-powered description generation (not implemented)
+- [ ] Parallel processing for large docs (not implemented)
+- [ ] Interactive migration wizard (TUI)
+- [ ] Incremental conversion (only changed files)
+- [ ] Custom component plugins
+- [ ] Automatic image optimization
+- [ ] Diff viewer for conversions
+- [ ] VS Code extension
+- [ ] Web-based converter UI
+- [ ] Support for Docusaurus → Mintlify
+- [ ] Support for GitBook → Mintlify
+- [ ] Migration analytics and reporting
+
+## 🤝 Contributing
+
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Support
+
+- Issues: [GitHub Issues](https://github.com/Olamideod/mintlify-convert/issues)
+
+## 🙏 Acknowledgments
+
+Built with ❤️ to help teams migrate to Mintlify faster.
+
+*Star ⭐ this repo if it helped you!*