Skills/Document Converter/Convert to Markdown

Convert to Markdown

~1 credits / MB of input (up to 5)

Converts a Word document, HTML page, EPUB, reStructuredText, or LaTeX file into clean Markdown. Structure (headings, lists, tables, links) is preserved; custom Word styling, comments, and tracked changes are stripped. PDF cannot be used as a source for this operation.

Use when

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

Not for

Extracting text out of a PDF, or preserving exact Word styling.

Cost

~1 credits / MB of input (up to 5)

A 3 MB input costs about 2 credits; larger inputs cost more.

Estimated; the actual charge depends on your input and is shown in the response.

What it accepts

Set these inside the intent when you run it.

source_filerequired

URL of the file to convert (Word, HTML, EPUB, reStructuredText, or LaTeX).

output_filenameoptional

Name for the resulting Markdown file.

What you get back

A download link to a .md file containing clean Markdown text.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Document Converter skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/document-converter/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"to_markdown","source_file":"https://example.com/spec.docx","output_filename":"spec.md"}}'

Example requests

  • Convert this Word doc to Markdown so I can put it in the repo
  • Turn this HTML page into Markdown for my wiki
  • I want a Markdown version of this EPUB