# 支援的轉換器

ConvertX-CN 完整版已內建 24 種轉換器，支援 1000+ 種格式。

---

## 轉換器總覽

| 轉換器           | 用途         | 輸入格式 | 輸出格式 |
| ---------------- | ------------ | -------- | -------- |
| FFmpeg           | 影音         | 472      | 199      |
| ImageMagick      | 圖片         | 253      | 183      |
| GraphicsMagick   | 圖片         | 167      | 130      |
| Vips             | 高效圖片處理 | 45       | 23       |
| LibreOffice      | 文件         | 41       | 22       |
| Pandoc           | 文件         | 43       | 65       |
| Calibre          | 電子書       | 31       | 21       |
| Inkscape         | 向量圖形     | 7        | 17       |
| libjxl           | JPEG XL      | 11       | 11       |
| libheif          | HEIF/HEIC    | 11       | 3        |
| Assimp           | 3D 模型      | 77       | 23       |
| Potrace          | 點陣轉向量   | 4        | 11       |
| VTracer          | 點陣轉向量   | 8        | 1        |
| resvg            | SVG 渲染     | 1        | 1        |
| XeLaTeX          | LaTeX        | 2        | 1        |
| dvisvgm          | 向量圖形     | 4        | 2        |
| Dasel            | 資料檔案     | 5        | 4        |
| msgconvert       | Outlook      | 1        | 1        |
| VCF to CSV       | 聯絡人       | 1        | 1        |
| Markitdown       | 文件轉 MD    | 6        | 1        |
| MinerU           | PDF → MD     | 7        | 2        |
| PDFMathTranslate | PDF 翻譯     | 1        | 15       |
| BabelDOC         | PDF 翻譯     | 1        | 45       |
| OCRmyPDF         | PDF OCR      | 1        | 7        |

---

## 影音轉換

### FFmpeg

最強大的影音轉換工具，支援幾乎所有影音格式。

<details>
<summary><strong>輸入格式（472 種）</strong></summary>

**影片格式：**
`264`, `265`, `266`, `3g2`, `3gp`, `4xm`, `asf`, `avi`, `avs`, `bik`, `dav`, `dv`, `f4v`, `flv`, `h261`, `h263`, `h264`, `h265`, `h266`, `hevc`, `m2ts`, `m2v`, `m4v`, `mk3d`, `mka`, `mks`, `mkv`, `mov`, `mp4`, `mpeg`, `mpg`, `mts`, `mxf`, `ogv`, `rm`, `rmvb`, `swf`, `ts`, `vob`, `webm`, `wmv`, `y4m`, `yuv`

**音訊格式：**
`aa`, `aac`, `ac3`, `ac4`, `aiff`, `amr`, `ape`, `au`, `caf`, `dts`, `eac3`, `flac`, `gsm`, `m4a`, `m4b`, `mka`, `mlp`, `mp2`, `mp3`, `mpa`, `oga`, `ogg`, `opus`, `ra`, `sbc`, `spx`, `tak`, `tta`, `voc`, `w64`, `wav`, `wma`, `wv`

**字幕格式：**
`ass`, `lrc`, `scc`, `smi`, `srt`, `ssa`, `stl`, `sub`, `sup`, `ttml`, `vtt`

**圖片序列：**
`bmp`, `dpx`, `exr`, `gif`, `j2k`, `jpeg`, `jpg`, `jxl`, `png`, `ppm`, `tga`, `tif`, `tiff`, `webp`

*以及更多格式...*

</details>

<details>
<summary><strong>輸出格式（199 種）</strong></summary>

**影片格式：**
`3g2`, `3gp`, `asf`, `avi`, `av1.mkv`, `av1.mp4`, `dv`, `f4v`, `flv`, `gif`, `h264.mkv`, `h264.mp4`, `h265.mkv`, `h265.mp4`, `h266.mkv`, `m2ts`, `m4v`, `mkv`, `mov`, `mp4`, `mpeg`, `mpg`, `mts`, `mxf`, `ogv`, `rm`, `swf`, `ts`, `vob`, `webm`, `wmv`, `y4m`

**音訊格式：**
`aac`, `ac3`, `adts`, `aiff`, `amr`, `au`, `caf`, `dts`, `eac3`, `flac`, `gsm`, `m4a`, `m4b`, `mkv`, `mp2`, `mp3`, `oga`, `ogg`, `opus`, `ra`, `sbc`, `spx`, `tta`, `voc`, `w64`, `wav`, `wma`, `wv`

**字幕格式：**
`ass`, `lrc`, `scc`, `srt`, `ssa`, `sub`, `sup`, `ttml`, `vtt`

**圖片格式：**
`bmp`, `dpx`, `exr`, `gif`, `ico`, `j2c`, `j2k`, `jpeg`, `jpg`, `jxl`, `png`, `ppm`, `tga`, `tif`, `tiff`, `webp`

</details>

**硬體加速：**

```yaml
environment:
  - FFMPEG_ARGS=-hwaccel cuda
  - FFMPEG_OUTPUT_ARGS=-c:v h264_nvenc
```

---

## 圖片處理

### ImageMagick

通用圖片處理工具，支援 250+ 種格式。

<details>
<summary><strong>輸入格式（253 種）</strong></summary>

**常見格式：**
`png`, `jpg`, `jpeg`, `gif`, `bmp`, `tiff`, `webp`, `avif`, `heic`, `heif`, `ico`, `psd`, `svg`, `pdf`, `eps`, `ai`

**RAW 相機格式：**
`3fr`, `arw`, `cr2`, `cr3`, `crw`, `dcr`, `dng`, `erf`, `fff`, `iiq`, `k25`, `kdc`, `mef`, `mrw`, `nef`, `nrw`, `orf`, `pef`, `raf`, `raw`, `rw2`, `rwl`, `sr2`, `srf`, `srw`, `x3f`

**向量格式：**
`svg`, `svgz`, `eps`, `pdf`, `ai`, `wmf`, `emf`

**特殊格式：**
`psd`, `psb`, `xcf`, `ora`, `miff`, `mng`, `jng`, `pcx`, `tga`, `dds`, `exr`, `hdr`, `dpx`, `cin`, `fits`, `palm`, `pdb`, `vicar`, `viff`

</details>

<details>
<summary><strong>輸出格式（183 種）</strong></summary>

**常見格式：**
`png`, `jpg`, `jpeg`, `gif`, `bmp`, `tiff`, `webp`, `avif`, `ico`, `pdf`, `eps`, `ps`, `svg`, `svgz`

**專業格式：**
`psd`, `psb`, `pcx`, `tga`, `dds`, `exr`, `hdr`, `dpx`, `cin`, `fits`

**特殊用途：**
`json` (metadata), `txt` (text extraction), `html` (image map)

</details>

### GraphicsMagick

高效能圖片處理，ImageMagick 的分支。

<details>
<summary><strong>輸入格式（167 種）</strong></summary>

`3fr`, `art`, `arw`, `avs`, `bmp`, `cal`, `cals`, `cin`, `cmyk`, `cr2`, `crw`, `cur`, `cut`, `dcm`, `dcr`, `dcx`, `dng`, `dpx`, `erf`, `exif`, `fax`, `fits`, `gif`, `gray`, `heic`, `heif`, `hrz`, `ico`, `jbg`, `jbig`, `jng`, `jpeg`, `jpg`, `k25`, `kdc`, `mac`, `mat`, `mef`, `miff`, `mng`, `mono`, `mrw`, `mtv`, `mvg`, `nef`, `orf`, `otb`, `pal`, `palm`, `pam`, `pbm`, `pcd`, `pct`, `pcx`, `pdb`, `pdf`, `pef`, `pfa`, `pfb`, `pgm`, `picon`, `pict`, `pix`, `png`, `pnm`, `ppm`, `ps`, `ptif`, `pwp`, `raf`, `ras`, `rgb`, `rgba`, `rla`, `rle`, `sct`, `sfw`, `sgi`, `sr2`, `srf`, `sun`, `svg`, `svgz`, `tga`, `tif`, `tiff`, `tim`, `ttf`, `txt`, `vicar`, `vid`, `viff`, `webp`, `wmf`, `wpg`, `x3f`, `xbm`, `xcf`, `xpm`, `xwd`, `yuv`

</details>

<details>
<summary><strong>輸出格式（130 種）</strong></summary>

`art`, `avs`, `bmp`, `cals`, `cin`, `cmyk`, `dcx`, `dpx`, `eps`, `fax`, `fits`, `gif`, `gray`, `histogram`, `html`, `ico`, `jbg`, `jbig`, `jng`, `jpeg`, `jpg`, `mat`, `miff`, `mng`, `mono`, `mtv`, `mvg`, `null`, `otb`, `pal`, `pam`, `pbm`, `pcd`, `pcl`, `pcx`, `pdb`, `pdf`, `pgm`, `picon`, `pict`, `png`, `pnm`, `ppm`, `ps`, `ptif`, `ras`, `rgb`, `rgba`, `sgi`, `sun`, `tga`, `tiff`, `txt`, `vicar`, `vid`, `viff`, `webp`, `xbm`, `xpm`, `xwd`, `yuv`

</details>

### Vips

高效能圖片處理，適合大型圖片。

<details>
<summary><strong>輸入格式（45 種）</strong></summary>

`avif`, `csv`, `exr`, `fits`, `gif`, `hdr`, `heic`, `heif`, `j2c`, `j2k`, `jp2`, `jpeg`, `jpx`, `jxl`, `mat`, `mrxs`, `ndpi`, `nia`, `nii`, `pdf`, `pfm`, `pgm`, `pic`, `png`, `ppm`, `raw`, `scn`, `svg`, `svs`, `svslide`, `szi`, `tif`, `tiff`, `v`, `vips`, `vms`, `vmu`, `webp`, `zip`

</details>

<details>
<summary><strong>輸出格式（23 種）</strong></summary>

`avif`, `dzi`, `fits`, `gif`, `hdr`, `heic`, `heif`, `j2c`, `j2k`, `jp2`, `jpeg`, `jpx`, `jxl`, `mat`, `nia`, `nii`, `png`, `tiff`, `vips`, `webp`

</details>

### 向量圖形工具

#### Inkscape

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `svg`, `pdf`, `eps`, `ps`, `wmf`, `emf`, `png` | `dxf`, `emf`, `eps`, `fxg`, `gpl`, `hpgl`, `html`, `odg`, `pdf`, `png`, `pov`, `ps`, `sif`, `svg`, `svgz`, `tex`, `wmf` |

#### Potrace（點陣轉向量）

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `pnm`, `pbm`, `pgm`, `bmp` | `svg`, `pdf`, `pdfpage`, `eps`, `postscript`, `ps`, `dxf`, `geojson`, `pgm`, `gimppath`, `xfig` |

#### VTracer（照片轉向量）

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `jpg`, `jpeg`, `png`, `bmp`, `gif`, `tiff`, `tif`, `webp` | `svg` |

#### resvg（SVG 渲染）

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `svg` | `png` |

#### dvisvgm（DVI/PDF 轉向量）

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `dvi`, `xdv`, `pdf`, `eps` | `svg`, `svgz` |

---

## 文件轉換

### LibreOffice

辦公文件轉換引擎。

<details>
<summary><strong>輸入格式（41 種）</strong></summary>

`602`, `abw`, `csv`, `cwk`, `doc`, `docm`, `docx`, `dot`, `dotx`, `dotm`, `epub`, `fb2`, `fodt`, `htm`, `html`, `hwp`, `mcw`, `mw`, `mwd`, `lwp`, `lrf`, `odt`, `ott`, `pages`, `pdf`, `psw`, `rtf`, `sdw`, `stw`, `sxw`, `tab`, `tsv`, `txt`, `wn`, `wpd`, `wps`, `wpt`, `wri`, `xhtml`, `xml`, `zabw`

</details>

<details>
<summary><strong>輸出格式（22 種）</strong></summary>

`csv`, `doc`, `docm`, `docx`, `dot`, `dotx`, `dotm`, `epub`, `fodt`, `htm`, `html`, `odt`, `ott`, `pdf`, `rtf`, `tab`, `tsv`, `txt`, `wps`, `wpt`, `xhtml`, `xml`

</details>

### Pandoc

標記語言文件轉換。

<details>
<summary><strong>輸入格式（43 種）</strong></summary>

`textile`, `tikiwiki`, `tsv`, `twiki`, `typst`, `vimwiki`, `biblatex`, `bibtex`, `bits`, `commonmark`, `commonmark_x`, `creole`, `csljson`, `csv`, `djot`, `docbook`, `docx`, `dokuwiki`, `endnotexml`, `epub`, `fb2`, `gfm`, `haddock`, `html`, `ipynb`, `jats`, `jira`, `json`, `latex`, `man`, `markdown`, `markdown_mmd`, `markdown_phpextra`, `markdown_strict`, `mediawiki`, `muse`, `native`, `opml`, `org`, `ris`, `rst`, `rtf`, `t2t`

</details>

<details>
<summary><strong>輸出格式（65 種）</strong></summary>

`tei`, `texinfo`, `textile`, `typst`, `xwiki`, `zimwiki`, `asciidoc`, `asciidoc_legacy`, `asciidoctor`, `beamer`, `biblatex`, `bibtex`, `chunkedhtml`, `commonmark`, `commonmark_x`, `context`, `csljson`, `djot`, `docbook`, `docbook4`, `docbook5`, `docx`, `dokuwiki`, `dzslides`, `epub`, `epub2`, `epub3`, `fb2`, `gfm`, `haddock`, `html`, `html4`, `html5`, `icml`, `ipynb`, `jats`, `jats_archiving`, `jats_articleauthoring`, `jats_publishing`, `jira`, `json`, `latex`, `man`, `markdown`, `markdown_mmd`, `markdown_phpextra`, `markdown_strict`, `markua`, `mediawiki`, `ms`, `muse`, `native`, `odt`, `opendocument`, `opml`, `org`, `pdf`, `plain`, `pptx`, `revealjs`, `rst`, `rtf`, `s5`, `slideous`, `slidy`

</details>

### Calibre

電子書轉換專家。

<details>
<summary><strong>輸入格式（31 種）</strong></summary>

`azw4`, `chm`, `cbr`, `cbz`, `cbt`, `cba`, `cb7`, `djvu`, `docx`, `epub`, `fb2`, `htlz`, `html`, `lit`, `lrf`, `mobi`, `odt`, `pdb`, `pdf`, `pml`, `rb`, `rtf`, `recipe`, `snb`, `tcr`, `txt`

</details>

<details>
<summary><strong>輸出格式（21 種）</strong></summary>

`azw3`, `docx`, `epub`, `fb2`, `html`, `htmlz`, `kepub.epub`, `lit`, `lrf`, `mobi`, `oeb`, `pdb`, `pdf`, `pml`, `rb`, `rtf`, `snb`, `tcr`, `txt`, `txtz`

</details>

### Markitdown

將文件轉換為 Markdown。

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `pdf`, `powerpoint`, `excel`, `docx`, `pptx`, `html` | `md` |

### XeLaTeX

LaTeX 文件編譯。

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `tex`, `latex` | `pdf` |

---

## 3D 模型轉換

### Assimp

開源 3D 模型轉換庫。

<details>
<summary><strong>輸入格式（77 種）</strong></summary>

`3d`, `3ds`, `3mf`, `ac`, `ac3d`, `acc`, `amf`, `amj`, `ase`, `ask`, `assbin`, `b3d`, `blend`, `bsp`, `bvh`, `cob`, `csm`, `dae`, `dxf`, `enff`, `fbx`, `glb`, `gltf`, `hmb`, `hmp`, `ifc`, `ifczip`, `iqm`, `irr`, `irrmesh`, `lwo`, `lws`, `lxo`, `m3d`, `md2`, `md3`, `md5anim`, `md5camera`, `md5mesh`, `mdc`, `mdl`, `mesh.xml`, `mesh`, `mot`, `ms3d`, `ndo`, `nff`, `obj`, `off`, `ogex`, `pk3`, `ply`, `pmx`, `prj`, `q3o`, `q3s`, `raw`, `scn`, `sib`, `smd`, `step`, `stl`, `stp`, `ter`, `uc`, `usd`, `usda`, `usdc`, `usdz`, `vta`, `x`, `x3d`, `x3db`, `xgl`, `xml`, `zae`, `zgl`

</details>

<details>
<summary><strong>輸出格式（23 種）</strong></summary>

`3ds`, `3mf`, `assbin`, `assjson`, `assxml`, `collada`, `dae`, `fbx`, `fbxa`, `glb`, `glb2`, `gltf`, `gltf2`, `json`, `obj`, `objnomtl`, `pbrt`, `ply`, `plyb`, `stl`, `stlb`, `stp`, `x`

</details>

---

## 圖片格式專用轉換器

### libjxl（JPEG XL）

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `jxl` | `apng`, `exr`, `jpeg`, `pam`, `pfm`, `pgm`, `pgx`, `png`, `ppm` |
| `apng`, `exr`, `gif`, `jpeg`, `pam`, `pfm`, `pgm`, `pgx`, `png`, `ppm` | `jxl` |

### libheif（HEIF/HEIC）

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `avci`, `avcs`, `avif`, `h264`, `heic`, `heics`, `heif`, `heifs`, `hif`, `mkv`, `mp4` | `jpeg`, `png`, `y4m` |

---

## 資料格式轉換

### Dasel

結構化資料格式轉換。

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `yaml`, `toml`, `json`, `xml`, `csv` | `yaml`, `toml`, `json`, `csv` |

### VCF to CSV

聯絡人格式轉換。

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `vcf` | `csv` |

### msgconvert

Outlook 郵件轉換。

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `msg` | `eml` |

---

## PDF 進階功能

### MinerU

將 PDF 轉換為結構化 Markdown。

| 輸入格式 | 輸出格式 |
| -------- | -------- |
| `pdf`, `ppt`, `pptx`, `xls`, `xlsx`, `doc`, `docx` | `md-t` (表格為 Markdown), `md-i` (表格為圖片) |

**輸出格式：** `.tar` 封裝，包含 Markdown 檔案與圖片資源

### PDFMathTranslate

翻譯 PDF 同時保留數學公式與排版。

**輸入格式：** `pdf`

**輸出格式（15 種）：**
| 目標語言 | 格式代碼 |
| -------- | -------- |
| 英文 | `pdf-en` |
| 繁體中文 | `pdf-zh-TW` |
| 簡體中文 | `pdf-zh` |
| 日文 | `pdf-ja` |
| 韓文 | `pdf-ko` |
| 德文 | `pdf-de` |
| 法文 | `pdf-fr` |
| 西班牙文 | `pdf-es` |
| 義大利文 | `pdf-it` |
| 葡萄牙文 | `pdf-pt` |
| 俄文 | `pdf-ru` |
| 阿拉伯文 | `pdf-ar` |
| 印地文 | `pdf-hi` |
| 越南文 | `pdf-vi` |
| 泰文 | `pdf-th` |

**環境變數：**

```yaml
- PDFMATHTRANSLATE_SERVICE=google # 翻譯服務
```

### BabelDOC

PDF 翻譯引擎，支援多種輸出格式。

**輸入格式：** `pdf`

**輸出格式（45 種）：**

支援 3 種輸出格式 × 15 種語言：
- PDF：`pdf-en`, `pdf-zh`, `pdf-zh-TW`, `pdf-ja`, `pdf-ko`, `pdf-de`, `pdf-fr`, `pdf-es`, `pdf-it`, `pdf-pt`, `pdf-ru`, `pdf-ar`, `pdf-hi`, `pdf-vi`, `pdf-th`
- Markdown：`md-en`, `md-zh`, `md-zh-TW`, `md-ja`, `md-ko`, `md-de`, `md-fr`, `md-es`, `md-it`, `md-pt`, `md-ru`, `md-ar`, `md-hi`, `md-vi`, `md-th`
- HTML：`html-en`, `html-zh`, `html-zh-TW`, `html-ja`, `html-ko`, `html-de`, `html-fr`, `html-es`, `html-it`, `html-pt`, `html-ru`, `html-ar`, `html-hi`, `html-vi`, `html-th`

### OCRmyPDF

將掃描版 PDF 轉換為可搜尋 PDF（加入文字層）。

**輸入格式：** `pdf`

**輸出格式（7 種）：**
| OCR 語言 | 格式代碼 |
| -------- | -------- |
| 英文 | `pdf-en` |
| 繁體中文 | `pdf-zh-TW` |
| 簡體中文 | `pdf-zh` |
| 日文 | `pdf-ja` |
| 韓文 | `pdf-ko` |
| 德文 | `pdf-de` |
| 法文 | `pdf-fr` |

---

## 內建依賴

ConvertX-CN 完整版已預載：

| 類別         | 內建內容                                     |
| ------------ | -------------------------------------------- |
| **文件轉換** | LibreOffice (headless)、Pandoc               |
| **LaTeX**    | TexLive Full                                 |
| **OCR**      | Tesseract + 繁/簡中、日、韓、英、德語言包    |
| **CJK 字型** | Noto CJK、Noto Emoji、微軟核心字型、標楷體   |
| **影音轉換** | FFmpeg、ImageMagick、GraphicsMagick、Vips    |
| **向量圖形** | Inkscape、Potrace、VTracer、resvg、dvisvgm   |
| **電子書**   | Calibre                                      |
| **3D 模型**  | Assimp                                       |
| **PDF 工具** | MinerU、PDFMathTranslate、BabelDOC、OCRmyPDF |
| **其他**     | Ghostscript、MuPDF、Poppler、libheif、libjxl |

---

## 新增轉換器

如需新增轉換器支援，歡迎：

1. 📝 [提交 Issue](https://github.com/pi-docket/ConvertX-CN/issues)
2. 🔧 [發送 Pull Request](https://github.com/pi-docket/ConvertX-CN/pulls)

---

## 相關文件

- [OCR 功能](OCR.md)
- [翻譯功能](翻譯功能.md)
- [Docker 部署](../部署指南/Docker部署.md)