Coolutils ConverterX — 一个实用的服务器解决方案，用于批量文件转换

Coolutils Converter X 是一款通用的服务器端 SDK，可接收 30 余种输入文件类型 — PDF、DOCX、XLSX、HTML、MHT、EML、MSG、TXT、RTF、EPS、XPS、PCL、图像等等 — 并输出 PDF、DOC、TIFF 或 XPS。一个二进制文件即可替代一整套针对特定格式的库；服务器上无需安装 Microsoft Office、Adobe Acrobat、Outlook 或其他外部运行时。它以静默方式运行：没有图形界面，没有对话框，没有弹窗。Coolutils Converter X 同时提供命令行二进制文件和 ActiveX/COM 接口，可无缝集成到 ASP、PHP、.NET、Python、Ruby、Java 以及任何支持 COM 的后端中。

完整的输入格式覆盖：

• PDF / 页面格式：PDF、EPS、XPS、PCL
• HTML 系列：HTML、XHTML、MHT
• 办公文档：DOC、DOCX、DOCM、RTF、TXT、ODT
• 电子表格：XLS、XLSX、XLSM、XLT、ODS
• 电子邮件：MSG（Outlook）、EML（RFC-822）
• 图像：TIFF、PNG、JPG、BMP、GIF

输出格式：PDF（支持 AES-256 加密、密码保护、按权限标志、X.509 数字签名、PDF/A 归档配置文件）、DOC、TIFF（单页或多页）、XPS。Bates 式编号戳记、自定义页眉/页脚（日期、页数、保密戳记、公司徽标）以及水印可统一应用于每一种输入格式 — 无论源文件是 DOCX、EML、JPEG 还是 HTML 页面，使用的都是同一组参数。

多用户友好：在 Windows 服务器上一次安装，即可将转换功能作为服务向整个网络开放，或作为 Web 端点向外部客户提供。多线程引擎以最高速度批量处理。兼容 IIS、Docker、Citrix 和 Wine。

当您的应用程序需要接受任意用户上传时，Coolutils Converter X 是正确的选择 — 您无需为每一种格式维护独立的代码路径。一次 Convert(src, dest, params) 调用即可处理全部内容。免费试用（30 天试用期，无任何限制），您会发现它确实物有所值。

当前支持的部分输入到输出组合：

CoolUtils RAG Adapter — 面向 AI 与 RAG 流水线的 Markdown 输出

LLM 智能体（Claude、ChatGPT、Cursor、Cline）和检索框架（LangChain、LlamaIndex、Haystack）并不读取 XLSX、PDF、MSG 或 DWG，它们读取的是文本。市面上的转换器 — pandoc、libreoffice --convert、pdftotext — 会把输入压成一根字符串，丢掉结构：工作表层级、合并单元格、公式、单位、表头、作者与语言元数据。检索层最终拿到的是噪声。

CoolUtils RAG Adapter 是所有 Total Converter X 产品共享的 Markdown 约定。给任意 X 转换器加上 -cMD，您就能得到一份干净的 GitHub-Flavored Markdown 文件，并带有 YAML frontmatter 块；再加上 -Docling，就会同时生成一份带类型信息的 .docling.json 旁路文件。输出可直接进入您的向量存储 — 无需胶水代码，也无需自定义加载器。

输出中包含的内容

• Markdown 正文（.md） — GitHub-Flavored：表格、围栏代码块、任务列表。文档结构（workbook → sheets、PDF → sections、mailbox → folders → messages、CAD drawing → layers）映射到 # / ## / ### 标题，使得分块器在语义边界处切分，而不会切在表格中间或段落中间。
• YAML frontmatter — source_file、format（MIME）、generator、created、结构性计数（sheets、pages、messages、layers）、检测到的 languages、若存在则包含 authors，以及源文件的 binary_hash 用于溯源。
• 可选的 .docling.json 旁路文件 — 符合 Docling schema 的 JSON：带单位的类型化列（EUR、pcs、kWh、%、日期）、规范化公式（=qty*unit_price）连同原始单元格坐标（of:=[.C5]*[.D5]）、表格边界矩形、页/工作表锚点，以及分块器可读取的 chunks_hint 数组。
• 双语 / 多语种表头保留 — 形如 "Цена / Price" 或 "数量 / Quantity" 的列标题在转换后完好保留。
• 主流框架开箱即用 — LangChain 的 UnstructuredMarkdownLoader、LlamaIndex 的 MarkdownReader、Haystack 的 MarkdownToDocument、Claude Code 的 MCP 文件工具，以及 Cursor 的 @-file 工作流均可直接消费输出。

相比 Docling、Unstructured.io、LlamaParse、Marker，为什么这点很重要

那些竞品解析器在 PDF 和 Office 上覆盖得还算不错，但在长尾格式上明显薄弱。CoolUtils 在上游的强项恰恰是长尾 — 200 多种格式，其中包括智能体常常踩坑的那些：XLSB、OFX、DWG、DXF、HPGL、PST、OST、MSG、EML、MBOX、MAPI XML、.pages、.numbers、ODS、Lotus WK2、DBF、EPS、XPS、PCL。有了 RAG Adapter，您的流水线无需为每种格式准备一种加载器 — CoolUtils 触及的一切都将变成同一套约定下的 Markdown。

支持的源格式 — 通过 Coolutils Converter X 和 X 系列

样例输出 — 一份 .ods 经过 RAG Adapter 后

输入：q4-forecast.ods，一个包含两个工作表、带双语表头、其中一列为公式的工作簿。

Markdown 正文（q4-forecast.md）：

---
source_file: q4-forecast.ods
format: application/vnd.oasis.opendocument.spreadsheet
generator: TotalExcelConverterX 6.2 (CoolUtils RAG Adapter)
created: 2026-05-25T10:14:22Z
sheets: 2
languages: [en, ru]
binary_hash: sha256:1f4c…b9e2
---

# q4-forecast

## Summary

| Период / Period | Выручка / Revenue (EUR) | Себестоимость / COGS (EUR) | Маржа / Margin (EUR) |
|-----------------|------------------------:|---------------------------:|---------------------:|
| Oct 2026        |                 124,300 |                     78,400 |               45,900 |
| Nov 2026        |                 138,750 |                     82,100 |               56,650 |
| Dec 2026        |                 161,200 |                     91,300 |               69,900 |

## Forecast

| SKU   | Qty (pcs) | Unit price (EUR) | Line total (EUR) |
|-------|----------:|-----------------:|-----------------:|
| A-100 |       420 |            12.50 |          5,250.00 |
| A-200 |       180 |            34.00 |          6,120.00 |
| B-050 |        95 |            89.90 |          8,540.50 |

旁路文件（q4-forecast.docling.json，节选）：

{
  "schema_version": "docling-1.0",
  "source": { "file": "q4-forecast.ods", "mime": "application/vnd.oasis.opendocument.spreadsheet", "binary_hash": "sha256:1f4c…b9e2" },
  "tables": [
    {
      "sheet": "Forecast",
      "anchor": { "sheet_index": 1, "range": "A1:D4" },
      "columns": [
        { "name": "SKU",        "type": "string" },
        { "name": "Qty",        "type": "integer", "unit": "pcs" },
        { "name": "Unit price", "type": "decimal", "unit": "EUR", "scale": 2 },
        { "name": "Line total", "type": "decimal", "unit": "EUR", "scale": 2,
          "formula": "=qty*unit_price",
          "formula_original": "of:=[.B2]*[.C2]" }
      ],
      "chunks_hint": [ { "rows": "1-4", "header_rows": 1 } ]
    }
  ]
}

如何集成

LangChain（Python）：

from langchain_community.document_loaders import UnstructuredMarkdownLoader

docs = UnstructuredMarkdownLoader("q4-forecast.md").load()
# YAML frontmatter is preserved as document metadata; headings drive splits.

LlamaIndex（Python）：

from llama_index.core import SimpleDirectoryReader

docs = SimpleDirectoryReader("./rag-input", required_exts=[".md"]).load_data()
# Drop .md + .docling.json next to each other; the typed columns
# stay queryable through the Docling-aware reader.

Claude Code（MCP，无需客户端代码）：

$ CoolUtilsConverterX.exe "C:\inbox\*.*" "C:\rag\" -cMD -Docling -Recurse
$ claude  # then: "Read q4-forecast.md and summarise margin trends."

哪些 Total Converter X 产品能输出 Markdown

下方列出的每个 X 系列转换器都内置 RAG Adapter — 相同的 -cMD 与 -Docling 参数、相同的 frontmatter、相同的旁路文件 schema：

• Total HTML Converter X — HTML、MHT、XHTML、实时 URL → Markdown
• Total PDF Converter X — PDF（文本 + OCR 层）→ 带页面锚点的 Markdown
• Total Doc Converter X — DOC、DOCX、RTF、TXT、ODT → Markdown
• Total Excel Converter X — XLS、XLSX、ODS、CSV、XML、Lotus → Markdown + 类型化列
• Total CSV Converter X — 带自定义分隔符的 CSV、TSV → Markdown
• Total Mail Converter X — EML、MSG、MBOX → Markdown（每封邮件一个文件，保留邮件线程）
• Total Mail Converter Pro X — 同上，并将内联附件渲染到 Markdown 正文中
• Total Outlook Converter X — PST、OST → 按文件夹组织的 Markdown 树
• Total Outlook Converter Pro X — PST/OST + 附件渲染
• Total Image Converter X — TIFF、JPEG、PNG、RAW、WebP → OCR → Markdown
• Total CAD Converter X — DWG、DXF、HPGL → 按图层/文字提取的 Markdown
• Total XML Converter X — 带 XSLT 的 XML → Markdown / JSON

RAG Adapter 从每款产品的 6.2 版本起提供。现有许可证持有者可作为免费更新获取；新购买者则随产品附带 — 没有单独的 SKU，也没有按格式收费的附加包。