file-converter

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

File Converter

文件转换器

Overview

概述

Convert files between formats across three categories: documents, data files, and images. Generate Python code dynamically for each conversion request, selecting appropriate libraries and handling edge cases.

可在文档、数据文件和图片三大类别之间进行文件格式转换。针对每个转换请求动态生成Python代码，选择合适的库并处理边缘情况。

Conversion Categories

转换类别

Documents

文档

From	To	Recommended Library
Markdown	HTML	`markdown` or `mistune`
HTML	Markdown	`markdownify` or `html2text`
HTML	PDF	`weasyprint` or `pdfkit` (requires wkhtmltopdf)
PDF	Text	`pypdf` or `pdfplumber`
DOCX	Markdown	`mammoth`
DOCX	PDF	`docx2pdf` (Windows/macOS) or LibreOffice CLI
Markdown	PDF	Convert via HTML first, then to PDF

源格式	目标格式	推荐库
Markdown	HTML	`markdown` 或 `mistune`
HTML	Markdown	`markdownify` 或 `html2text`
HTML	PDF	`weasyprint` 或 `pdfkit` （需要wkhtmltopdf）
PDF	文本	`pypdf` 或 `pdfplumber`
DOCX	Markdown	`mammoth`
DOCX	PDF	`docx2pdf` （Windows/macOS）或LibreOffice CLI
Markdown	PDF	先转换为HTML，再转为PDF

Data Files

数据文件

From	To	Recommended Library
JSON	YAML	`pyyaml`
YAML	JSON	`pyyaml`
JSON	CSV	`pandas` or stdlib `csv` + `json`
CSV	JSON	`pandas` or stdlib `csv` + `json`
JSON	TOML	`tomli` / `tomllib` (read) + `tomli-w` (write)
XML	JSON	`xmltodict`
JSON	XML	`dicttoxml` or `xmltodict.unparse`

源格式	目标格式	推荐库
JSON	YAML	`pyyaml`
YAML	JSON	`pyyaml`
JSON	CSV	`pandas` 或标准库 `csv` + `json`
CSV	JSON	`pandas` 或标准库 `csv` + `json`
JSON	TOML	`tomli` / `tomllib` （读取） + `tomli-w` （写入）
XML	JSON	`xmltodict`
JSON	XML	`dicttoxml` 或 `xmltodict.unparse`

Images

图片

From	To	Recommended Library
PNG/JPG/WebP/GIF	Any raster	`Pillow` (PIL)
SVG	PNG/JPG	`cairosvg` or `svglib` + `reportlab`
PNG	SVG	`potrace` (CLI) for tracing, limited fidelity

源格式	目标格式	推荐库
PNG/JPG/WebP/GIF	任何光栅格式	`Pillow` （PIL）
SVG	PNG/JPG	`cairosvg` 或 `svglib` + `reportlab`
PNG	SVG	`potrace` （CLI）用于追踪，保真度有限

Workflow

工作流程

Identify source format (from file extension or user statement)
Identify target format
Check
```
references/
```
for format-specific guidance
Generate conversion code using recommended library
Handle edge cases (encoding, transparency, nested structures)
Execute conversion and report results

识别源格式（通过文件扩展名或用户描述）
识别目标格式
查看
```
references/
```
获取格式特定指南
使用推荐库生成转换代码
处理边缘情况（编码、透明度、嵌套结构）
执行转换并报告结果

Quick Patterns

快速示例

Data: JSON to YAML

数据：JSON转YAML

python

import json
import yaml

with open("input.json") as f:
    data = json.load(f)

with open("output.yaml", "w") as f:
    yaml.dump(data, f, default_flow_style=False, allow_unicode=True)

python

import json
import yaml

with open("input.json") as f:
    data = json.load(f)

with open("output.yaml", "w") as f:
    yaml.dump(data, f, default_flow_style=False, allow_unicode=True)

Data: CSV to JSON

数据：CSV转JSON

python

import csv
import json

with open("input.csv") as f:
    reader = csv.DictReader(f)
    data = list(reader)

with open("output.json", "w") as f:
    json.dump(data, f, indent=2)

python

import csv
import json

with open("input.csv") as f:
    reader = csv.DictReader(f)
    data = list(reader)

with open("output.json", "w") as f:
    json.dump(data, f, indent=2)

Document: Markdown to HTML

文档：Markdown转HTML

python

import markdown

with open("input.md") as f:
    md_content = f.read()

html = markdown.markdown(md_content, extensions=["tables", "fenced_code"])

with open("output.html", "w") as f:
    f.write(html)

python

import markdown

with open("input.md") as f:
    md_content = f.read()

html = markdown.markdown(md_content, extensions=["tables", "fenced_code"])

with open("output.html", "w") as f:
    f.write(html)

Image: PNG to WebP

图片：PNG转WebP

python

from PIL import Image

img = Image.open("input.png")
img.save("output.webp", "WEBP", quality=85)

python

from PIL import Image

img = Image.open("input.png")
img.save("output.webp", "WEBP", quality=85)

Image: SVG to PNG

图片：SVG转PNG

python

import cairosvg

cairosvg.svg2png(url="input.svg", write_to="output.png", scale=2)

python

import cairosvg

cairosvg.svg2png(url="input.svg", write_to="output.png", scale=2)

Resources

资源

Detailed guidance for complex conversions is in

references/

```
references/document-conversions.md
```
- PDF handling, encoding issues, styling preservation
```
references/data-conversions.md
```
- Schema handling, type coercion, nested structures
```
references/image-conversions.md
```
- Quality settings, transparency, color profiles

Consult these references when handling edge cases or when the user has specific quality/fidelity requirements.

复杂转换的详细指南位于

references/

目录下：

```
references/document-conversions.md
```
- PDF处理、编码问题、样式保留
```
references/data-conversions.md
```
- 模式处理、类型转换、嵌套结构
```
references/image-conversions.md
```
- 质量设置、透明度、颜色配置文件

处理边缘情况或用户有特定质量/保真度要求时，请参考这些文档。