---
title: dir2md - Repository to Markdown Converter
emoji: 📂
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.45.0
app_file: app.py
pinned: false
license: mit
short_description: Convert GitHub repos to LLM-friendly markdown blueprints
tags:
- developer-tools
- markdown
- repository-analysis
- llm
- code-analysis
- python
---

# 📂 dir2md: Repository to Markdown Converter

**Transform any GitHub repository into LLM-optimized markdown documentation**

This interactive demo showcases dir2md's powerful repository analysis capabilities. Simply paste a GitHub URL and watch as your codebase is transformed into a comprehensive, LLM-friendly markdown blueprint.

## ✨ What This Demo Does

- 🔍 **Smart Repository Analysis**: Automatically analyzes directory structure and file types
- 📊 **File Type Distribution**: Visual breakdown of your codebase composition
- 🔑 **Key File Detection**: Identifies important files like README, package.json, requirements.txt
- 📄 **Content Sampling**: Includes preview of key file contents
- 💾 **Downloadable Output**: Get your markdown blueprint as a downloadable file

## 🚀 Try It Now

1. **Enter a GitHub URL** (e.g., `https://github.com/octocat/Hello-World`)
2. **Choose content options** (include file previews or structure-only)
3. **Click Convert** and watch the magic happen!
4. **Download** your markdown blueprint

## 🎯 Perfect For

- **LLM Context Preparation**: Optimize repositories for AI-assisted development
- **Code Documentation**: Generate comprehensive project overviews
- **Repository Analysis**: Understand codebase structure at a glance
- **Developer Onboarding**: Create readable project summaries

## 📋 Example Output

The demo generates structured markdown including:
- Complete directory tree visualization
- File type statistics and distribution
- Key configuration files content
- Project metadata and structure analysis

## 🔗 Related Projects

- **[Full dir2md Project](https://github.com/Flamehaven/dir2md)** - Complete CLI tool with advanced features
- **[CRoM Demo](https://huggingface.co/spaces/Flamehaven/crom-demo)** - Context management for LLMs
- **[Ethics Drift Demo](https://huggingface.co/spaces/Flamehaven/drift-ethics-demo)** - AGI safety simulation

---

*Built with ❤️ using Gradio • [View Source](https://github.com/Flamehaven/dir2md)*