anything2md 0.1.2

Convert documents to Markdown using Cloudflare Workers AI toMarkdown.

anything2md

Python package and CLI for converting URLs or local documents into Markdown using Cloudflare Workers AI toMarkdown().

Install

From PyPI with uv:

uv add anything2md

Or from PyPI (pip):

pip install anything2md

Cloudflare Token Setup

Create a Cloudflare API Token for the target account and include these permissions:

• Workers AI -- Read
• Browser Rendering -- Edit

Usage

import anything2md

mdconverter = anything2md(account_id="xxx", api_token="xxx")
result = mdconverter.transform("https://example.com")
result = mdconverter.transform("https://pub-979cb28270cc461d94bc8a169d8f389d.r2.dev/somatosensory.pdf")
result = mdconverter.transform("https://pub-979cb28270cc461d94bc8a169d8f389d.r2.dev/cat.jpeg")
print(result.markdown)

Supported Formats

Based on Cloudflare docs, current supported extensions include:

pdf, jpeg/jpg, png, webp, svg, html/htm, xml, csv, docx, xlsx, xlsm, xlsb, xls, et, ods, odt, numbers

url via Browser Rendering Markdown endpoint.

Local Usage

Install dependencies:

uv sync

export CLOUDFLARE_ACCOUNT_ID="your_account_id"
export CLOUDFLARE_API_TOKEN="your_api_token"

uv run anything2md https://pub-979cb28270cc461d94bc8a169d8f389d.r2.dev/somatosensory.pdf
uv run anything2md https://pub-979cb28270cc461d94bc8a169d8f389d.r2.dev/cat.jpeg -o output.md
uv run anything2md https://example.com

Integration Test (Real Cloudflare)

If both CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_API_TOKEN are set, integration tests automatically run real Cloudflare calls and validate that:

• result.error is empty
• result.markdown is non-empty

Optional test URL overrides:

• ANYTHING2MD_TEST_PDF_URL
• ANYTHING2MD_TEST_IMAGE_URL
• ANYTHING2MD_TEST_WEB_URL

References

Cloudflare docs:

• Markdown Conversion overview: https://developers.cloudflare.com/workers-ai/features/markdown-conversion/
• API reference (toMarkdown): https://developers.cloudflare.com/api/resources/ai/methods/run/#to-markdown-conversion-to-markdown
• API reference (supported formats): https://developers.cloudflare.com/api/resources/ai/methods/run/#to-markdown-conversion-supported-formats
• Browser Rendering Markdown endpoint (URL input): https://developers.cloudflare.com/browser-rendering/rest-api/markdown-endpoint/
• Markdown for Agents (Accept: text/markdown): https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/

License

MIT