Skip to main content

Documentation

Learn how to use To-Markdown converter and integrate it into your workflow.

Getting Started

Converting your documents to Markdown is simple:

  1. Choose your conversion method (Upload, URL, YouTube URL, or Text)
  2. Select or paste your content
  3. Click Convert
  4. Download or copy your Markdown

Supported Formats

Documents

  • PDF (.pdf)
  • Word / RTF / ODT
  • PowerPoint / ODP
  • Excel / ODS
  • EPUB (.epub)

Web & Text

  • HTML (.html, .htm)
  • Text (.txt, .csv, .json, .xml)
  • Images with OCR
  • Markdown (.md, .markdown)
  • YouTube video URLs (watch/shorts/youtu.be)

Conversion Options

Conversion behavior currently uses service defaults. Per-request option flags are not supported yet.

  • Automatic format detection from file content
  • Markdown output with normalized line breaks
  • OCR endpoint for image-to-markdown extraction
  • URL and YouTube conversion endpoints for online sources
  • 10MB max file size per request
  • Rate-limited API endpoints
  • Async conversion queue endpoint for long-running jobs

Workflow Guides

Conversion extracts useful content. These guides cover the review and destination-specific work that follows.

Convert documents to Markdown for RAG ingestion A practical document-to-Markdown workflow for RAG ingestion: extract source content, review structure, preserve provenance, then chunk and index it downstream. Import documents into Obsidian as Markdown Convert Word, PowerPoint, and images to Markdown for Obsidian, then review links, attachments, properties, and note structure before adding it to your vault. Prepare converted Markdown for GitHub documentation Turn Word or PowerPoint content into reviewed Markdown for GitHub, MkDocs, or Docusaurus, including links, assets, front matter, navigation, and build checks.

API Integration

Integrate To-Markdown into your applications:

  • RESTful API endpoints
  • Multiple authentication methods
  • Comprehensive documentation
  • Code examples in multiple languages

Use the dedicated converter at youtube.to-markdown.com for YouTube-first workflows.

For detailed API documentation, visit our API Reference.

Frequently Asked Questions

What is the maximum file size?

The maximum file size for conversion is 10MB per file.

How long are files stored?

Files are automatically deleted after conversion is complete.

Is batch conversion supported?

No. Current APIs process one file per request.

Are my files secure?

Yes, all file transfers are encrypted and files are automatically deleted after conversion.

Do you support YouTube conversion?

Yes. Submit a YouTube URL to the dedicated endpoint to convert transcript-ready content to Markdown.