VOIDER commited on
Commit
c08fd25
·
verified ·
1 Parent(s): 4ec5c26

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +38 -7
README.md CHANGED
@@ -1,13 +1,44 @@
1
  ---
2
- title: Repo To Md
3
- emoji: 🦀
4
- colorFrom: gray
5
- colorTo: yellow
6
  sdk: gradio
7
- sdk_version: 5.24.0
8
  app_file: app.py
9
  pinned: false
10
- short_description: converts a repository to MD
11
  ---
12
 
13
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: Repo to Markdown Converter
3
+ emoji: 📄
4
+ colorFrom: blue
5
+ colorTo: green
6
  sdk: gradio
7
+ sdk_version: 4.12.0 # Or whichever version you used
8
  app_file: app.py
9
  pinned: false
10
+ license: mit # Or choose another appropriate license
11
  ---
12
 
13
+ # Repo to Markdown Converter
14
+
15
+ This Hugging Face Space converts a Git repository (from a URL) or an uploaded local folder (as a `.zip` archive) into a single Markdown file.
16
+
17
+ **Features:**
18
+
19
+ * Supports public Git repository URLs.
20
+ * Supports uploading local project folders (packaged as `.zip`).
21
+ * Generates a directory structure overview.
22
+ * Includes the content of text/code files within fenced code blocks.
23
+ * Attempts syntax highlighting using file extensions.
24
+ * Allows customizing file/directory ignore patterns.
25
+ * Option to set a maximum file size for content inclusion.
26
+ * Provides the generated Markdown for viewing and download.
27
+
28
+ **How to Use:**
29
+
30
+ 1. Select the **Input Source**: "URL" or "Upload ZIP".
31
+ 2. **If URL:** Enter the full HTTPS URL of the public Git repository.
32
+ 3. **If Upload ZIP:** Click or drag-and-drop your `.zip` file containing the project folder.
33
+ 4. **(Optional)** Modify the **Ignore Patterns** (comma-separated). Sensible defaults are provided. Add `/` at the end for directory patterns (e.g., `node_modules/`).
34
+ 5. **(Optional)** Adjust the **Max File Size** limit (in KB). Files larger than this will be listed, but their content won't be included in the Markdown.
35
+ 6. Click **Generate Markdown**.
36
+ 7. The generated Markdown will appear in the output panel.
37
+ 8. A **Download .md File** button will appear once generation is complete.
38
+
39
+ **Limitations:**
40
+
41
+ * Only works with publicly accessible Git repositories (no authentication).
42
+ * Large repositories or files might take time or exceed resource limits.
43
+ * Binary file detection is basic; some binary files might be misidentified as text, or vice-versa.
44
+ * ZIP extraction assumes a standard structure; deeply nested or unusually structured ZIPs might not process correctly.