Design & media

Doc2Markdown

Try it

Convert supported documents into Markdown for agent-side reading, with local output and optional image-preserving packages.

What it does

Doc2Markdown converts supported document files to Markdown and saves the result beside the source. It supports `--md` for one merged file without images, or a ZIP package with extracted images and HTML-rendered tables. Conversion polls for up to 60 seconds, then provides a document ID for a later check if needed. Files are uploaded to the docchain cloud service over HTTPS; no API key, account, or external dependency is required.

When to use it

  • Reading or analyzing PDF or Office documents
  • Converting a document to one Markdown file
  • Preserving images and tables in a package
  • Retrying a conversion that exceeds 60 seconds

The skill document

doc2markdown

Document conversion assistant that automatically converts documents to Markdown (MD), saving output to the same directory as the source file. Designed to help intelligent agents read and process document content in various formats.

Quick Start

# Convert document (auto-polls for 60s, downloads if complete, returns doc ID if timeout)
node scripts/doc2markdown.js convert      # Downloads MD package
node scripts/doc2markdown.js convert  --md  # Downloads single MD file

# Check status and download (for documents that exceeded timeout)
node scripts/doc2markdown.js check       # Downloads MD package
node scripts/doc2markdown.js check   --md  # Downloads single MD file

Capabilities

  • Supported formats: docx, doc, pdf, ppt, pptx, xls, xlsx, jpg, jpeg, png, ceb, teb, caj, odt, ofd, cebx, odp, ott, wps, ods, et, dps, epub, chm, sdc, sdd, sdw, mobi, etc.
  • Preserves document structure, tables, and images
  • No API Key or account required, zero external dependencies
  • Downloaded ZIP files are extracted to {doc_id}_{filename}/ under the source file's parent directory; single MD files are saved directly there

When to Use

  • User requests to "read", "extract", "convert", or "view" a document
  • User provides a document path and asks about its content
  • User needs to summarize or analyze a document
  • User needs to convert document content to Markdown package

Download Modes

This tool supports two download modes:

  • --md mode: Downloads a single merged MD file to the source file's parent directory. Images are not included
  • MD package: Downloads and extracts a ZIP package to {doc_id}_{filename}/ in the source file's parent directory. Includes image files and tables, tables are rendered in HTML format

Choosing the Right Mode

User IntentExample PhrasesMode to Use
Read / view / analyze a document"read this file", "what's in this doc", "summarize this PDF"--md (single MD file)
Explicitly convert to MD"convert to MD", "export as markdown", "转成MD"MD package (default, no --md); use --md only if user specifically asks for a single file

Workflow

convert — Convert Document

  1. Invoke file parsing service
  2. Auto-poll conversion status (up to 60 seconds)
  3. Completes within 60s → Auto-download to source file directory
  4. Exceeds 60s → Return doc ID for subsequent check query

check — Query and Download

  1. Provide the previously returned doc ID
  2. Download if complete, otherwise continue polling for 60 seconds
  3. Prompt to retry later if still not complete

Data & Privacy

  • convert uploads files to the docchain cloud service (lab.hjcloud.com) for parsing. Results are returned as a ZIP archive and extracted locally.
  • All transfers use HTTPS encryption.
  • Users should ensure that documents do not contain sensitive or confidential information unless they have verified the service's data handling practices.
  • Service endpoint: https://lab.hjcloud.com/llmdoc

Feedback & Support

For parsing errors, format issues, or other problems, please submit an issue on GitHub: https://github.com/wct-lab/docchain-skills

Questions people ask

Which file formats are supported?
The document lists docx, doc, pdf, ppt, pptx, xls, xlsx, jpg, jpeg, png, ceb, teb, caj, odt, ofd, cebx, odp, ott, wps, ods, et, dps, epub, chm, sdc, sdd, sdw, and mobi, plus other formats described as “etc.”
Where are the conversion results saved?
`--md` saves a single merged MD file in the source file’s parent directory. The default mode downloads a ZIP package and extracts it to `{doc_id}_{filename}/` there; the package includes images and HTML-rendered tables, while `--md` does not include images.
What happens if conversion takes longer than 60 seconds?
`convert` polls for up to 60 seconds and returns a document ID if it times out. Use `check` with that ID to poll for another 60 seconds; if conversion is still incomplete, the tool asks you to retry later.

Related skills

doc to video, word to video, markdown to video, document to video — parse the document, outline, storyboard, voiceover, build, validate. Use when the user gives a Doc / Word / Markdown file and wants an explainer, report broadcast, or training video.

Convert Word (.doc, .docx), PowerPoint (.ppt, .pptx), Excel (.xls, .xlsx), OpenDocument (.odt, .ods, .odp), RTF, EPUB, CSV, and PDF files to GitHub-Flavored Markdown. Use when a task needs the contents of an office document, spreadsheet, presentation, ebook, or PDF you cannot read directly.

1 installs

Converts PDF, DOCX, XLSX, PPTX, HTML, CSV, and other files to Markdown using the @covoyage/file2md CLI (@covoyage/file2md). Use when the user needs office do...

1 installs

Convert Markdown files to formatted Word documents (.docx). Use when the user asks to convert, export, or save a Markdown file as Word/DOCX format. Triggers...

24 installs1 stars

Transform Markdown or outlines into polished Word/PDF documents with professional templates

6 installs1 stars

Convert a Markdown file or raw Markdown string into a polished Word DOCX document. Supports custom Word template files, includes built-in DOCX templates, and...

23 installs1 stars