Skills/Document Converter/Convert between formats

Convert between formats

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

Converts a document between authoring and markup formats: reStructuredText, LaTeX, HTML, or stripped plain text. Use the LaTeX output path when you need equations or citations and plan to compile the resulting .tex file yourself. PDF cannot be used as a source.

Use when

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

Not for

Reading a PDF, or producing a finished Word, PDF, or EPUB deliverable (those have their own paths).

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 source file (Markdown, HTML, Word, reStructuredText, LaTeX, or plain text).

output_formatrequired

Target authoring format: rst, latex, html, or plain.

output_filenameoptional

Name for the resulting file, including the correct extension.

What you get back

A download link to the converted file in the requested authoring format (.rst, .tex, .html, or .txt).

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":"interchange","source_file":"https://example.com/notes.md","output_format":"rst","output_filename":"notes.rst"}}'

Example requests

  • Convert this Markdown file to reStructuredText for Sphinx
  • Turn this HTML into plain text, stripping all formatting
  • Convert my Markdown to LaTeX so I can compile it with equations