# Document Converter

> Skill `document-converter` on Faro. 5 sub-skills.

Converts documents between formats: Word to PDF, HTML to PDF, PDF to Word, Markdown to EPUB, and moves files between authoring formats like reStructuredText, LaTeX, and plain text. Provide the source file and the target format, and get back a download link to the converted document.

**Category:** Documents  
**Tags:** convert, document, markdown, pdf, docx, html  
**Use when:** You have one file in one format and need it in another, e.g. Markdown to Word, HTML to PDF, or a Word doc back to clean Markdown.  
**Not for:** Reading text or tables out of a PDF, OCR of scanned pages, math or citations rendered into a PDF, branded or templated Word from a corporate reference doc, spreadsheets or slide decks, or merging several files into one.  
**Returns:** file — Returns a download link to the converted file with a time-limited validity, not the file bytes inline.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/document-converter/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Convert this Markdown file to a Word document"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run document-converter "Convert this Markdown file to a Word document"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Convert this Markdown file to a Word document
- Convert this HTML page to a PDF
- Convert this Word doc to Markdown so I can put it in the repo
- Package my Markdown guide as an EPUB ebook

## Sub-skills

### Convert to Word

Turns structured text or markup into an editable Word document.

**Cost:** ~1 credits / MB of input (up to 5) — A 3 MB input costs about 2 credits; larger inputs cost more.

**Use when:** You authored content as Markdown, HTML, or another markup and need a Word file a person can open and edit.

**Details:** https://askfaro.com/llms/skills/document-converter/to_office.md

---

### Convert to PDF

Renders text or HTML into a polished PDF for print or archival.

**Cost:** ~1 credits / MB of input (up to 5) — A 3 MB input costs about 2 credits; image-heavy inputs cost more.

**Use when:** You need a final, printable, or archival PDF of Markdown or HTML content.

**Details:** https://askfaro.com/llms/skills/document-converter/to_pdf.md

---

### Convert to Markdown

Turns a Word, HTML, or markup file into clean Markdown text.

**Cost:** ~1 credits / MB of input (up to 5) — A 3 MB input costs about 2 credits; larger inputs cost more.

**Use when:** You want a file as editable plain text to paste into a wiki or repo, or to feed a model.

**Details:** https://askfaro.com/llms/skills/document-converter/to_markdown.md

---

### Convert to EPUB

Packages long-form Markdown or HTML content into an EPUB ebook.

**Cost:** ~1 credits / MB of input (up to 5) — A 3 MB input costs about 2 credits; larger inputs cost more.

**Use when:** You want to distribute long-form content as an ebook file.

**Details:** https://askfaro.com/llms/skills/document-converter/to_ebook.md

---

### Convert between formats

Moves a file between authoring formats such as reStructuredText, LaTeX, HTML, or plain text.

**Cost:** ~1 credits / MB of input (up to 5) — A 3 MB input costs about 2 credits; larger inputs cost more.

**Use when:** You are moving a file between markup or authoring formats inside a publishing workflow, or need plain stripped text.

**Details:** https://askfaro.com/llms/skills/document-converter/interchange.md

---

---
On the web: https://askfaro.com/search/document-converter