project-to-markdown

KO | EN

gitlite — search

#javascript #ai #typescript #llm #linux #docker #nodejs #macos #cli #kubernetes #awesome-list #security #openai #open-source

project-to-markdown

(★ 22)

Project To Markdown: Project files into structured markdown, optimizing documentation for AI analysis. Enhances AI assistants' performance in understanding project context, featuring both GUI and CLI interfaces. Ideal for improving AI-powered code comprehension and problem-solving.

project-to-markdown 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Project To Markdown

**Project To Markdown** is a Python application that converts project files into structured markdown format, optimizing documentation for AI analysis. Designed to enhance the performance of advanced language models like **GPT and Claude**, it improves the efficiency of AI Retrieval-Augmented Generation (RAG) systems.

The tool offers both GUI and CLI, making it accessible to various users. By transforming content into an AI-friendly format, Project To Markdown enables AI assistants to provide more accurate and context-aware responses when queried about project details.

## Demo

Use GUI version to generate markdown results. Then, attach these results to GPT or Claude Chat to get more accurate answers to your questions.

![project-to-markdown-preview](https://github.com/user-attachments/assets/cb02da9e-0b68-4f69-8ceb-a1cc28784b2e)

https://github.com/user-attachments/assets/8049c059-d0fe-4994-80bf-3e6f01e70879

## Recommended Use Cases

1. Document your entire project in markdown format and have it reviewed by AI. Use it to solve complex problems that span multiple files. This approach is easier as it doesn't require learning new AI tools and can be directly applied to existing AI chat interfaces.

2. Document the 'examples' folder of new or lesser-known open-source repositories. AI models don't always have the most up-to-date information, so this method can yield higher quality responses. When there's a lot of practical example data, it can significantly accelerate app development.

## Features

- Convert project files to markdown, split by subfolder.
- Merge all files into a single markdown file (optional)
- Add timestamps to generated markdown filenames (optional)
- Generate a folder structure of the project (optional)
- GUI for easy interaction
- CLI for automation and scripting
- Respects .gitignore rules

## Installation

1. Clone the repository:
   ```
   git clone https://github.com/easydevv/project-to-markdown.git
   cd project-to-markdown
   ```

2. Set up a virtual environment:
   ```
   python -m venv .venv
   ```
   ```
   .venv\scripts\activate
   ```

3. Install the required dependencies:
   ```
   pip install -r requirements.txt
   ```

## Usage

### GUI Version

To run the GUI version of the application:

```
python main.py
```
or 
```
flet run
```

The GUI allows you to:
- Select a project directory
- Choose conversion options
- Start the conversion process
- View the conversion log

### CLI Version

To run the command-line version:

```
python main_cmd.py PROJECT_PATH [OPTIONS]
```

Options:
- `--onefile`: Merge all files into a single markdown file
- `--timestamp`: Add timestamps to generated markdown filenames
- `--no-tree`: Do not generate a folder structure file

Example:
```
python main_cmd.py /path/to/your/project --onefile --timestamp 
```

## Configuration

The application uses a `config.json` file to store default settings. You can modify this file to change the default behavior:

```
{
  "exclude_types": ["md", "log", "pyc", ...],
  "exclude_folders": [".output-md", "__pycache__", ...],
  "output_folder": ".output-md",
  "max_workers": 4
}
```

- `exclude_types`: File extensions to exclude from conversion
- `exclude_folders`: Folders to exclude from conversion
- `output_folder`: Default folder for generated markdown files
- `max_workers`: (not working yet) Maximum number of concurrent workers for file processing

project-to-markdown

project-to-markdown 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

project-to-markdown

project-to-markdown 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README