How xuligexu/convert-file works
Universal File Converter is a local desktop app that turns selected or dropped files into Markdown or JSON. The principal workflow is: choose a target and files, validate supported formats, select an output folder, extract structured content, serialize it, then save and report results. The graph separates the GUI/controller, extraction, and output-format layers. README claims and the sampled source support the major format families; unsampled implementation details are not expanded into separate components.
Main entry points: main.py Conversion controller · extractor.py Format extractors · to_markdown.py Markdown serializer · to_json.py JSON serializer
Components 13
Desktop app
- Drop zones
main.py - File selection
main.py - Format validation
main.py - Conversion controller
main.py - Output folder
main.py - Completion status
main.py
Content extraction
- Format extractors
core/extractor.py - Structured paragraphs
core/extractor.py
Output formats
- Markdown serializer
core/to_markdown.py - JSON serializer
core/to_json.py
Other components
- User
- Local files
- Markdown / JSON files
Connections 17
- User → Drop zones: chooses target
README.md - User → File selection: adds files
README.md - Drop zones → Conversion controller: starts conversion
main.py - File selection → Format validation: provides paths
main.py - Format validation → Conversion controller: passes valid files
main.py - User → Output folder: chooses folder
README.md - Conversion controller → Format extractors: extracts content
main.py - Local files → Format extractors: reads files
core/extractor.py - Format extractors → Structured paragraphs: produces paragraphs
core/extractor.py - Conversion controller → Markdown serializer: serializes as Markdown
main.py - Conversion controller → JSON serializer: serializes as JSON
main.py - Markdown serializer → Structured paragraphs: reads paragraphs
core/to_markdown.py - JSON serializer → Structured paragraphs: reads paragraphs
core/to_json.py - Conversion controller → Markdown / JSON files: writes results
main.py - Output folder → Markdown / JSON files: sets output location
README.md - Conversion controller → Completion status: reports results
main.py - Completion status → User: shows status
main.py