https://github.com/herrkaefer/anything2md
Python package and CLI for converting documents to Markdown using Cloudflare Workers AI toMarkdown.
https://github.com/herrkaefer/anything2md
automation cli cloudflare cloudflare-workers cloudflare-workers-ai content-extraction developer-tools document-conversion document-to-markdown docx-to-markdown file-conversion image-to-markdown markdown markdown-converter ocr pdf pdf-to-markdown python workers-ai xlsx-to-markdown
Last synced: about 2 months ago
JSON representation
Python package and CLI for converting documents to Markdown using Cloudflare Workers AI toMarkdown.
- Host: GitHub
- URL: https://github.com/herrkaefer/anything2md
- Owner: herrkaefer
- Created: 2026-02-27T16:06:44.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-02-27T18:41:52.000Z (about 2 months ago)
- Last Synced: 2026-02-27T21:26:59.620Z (about 2 months ago)
- Topics: automation, cli, cloudflare, cloudflare-workers, cloudflare-workers-ai, content-extraction, developer-tools, document-conversion, document-to-markdown, docx-to-markdown, file-conversion, image-to-markdown, markdown, markdown-converter, ocr, pdf, pdf-to-markdown, python, workers-ai, xlsx-to-markdown
- Language: Python
- Size: 66.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# anything2md
```text
__ __ _ ___ __
____ _____ __ __/ /_/ /_ (_)___ ____ |__ \ ____ ___ ____/ /
/ __ `/ __ \/ / / / __/ __ \/ / __ \/ __ `/_/ // __ `__ \/ __ /
/ /_/ / / / / /_/ / /_/ / / / / / / / /_/ / __// / / / / / /_/ /
\__,_/_/ /_/\__, /\__/_/ /_/_/_/ /_/\__, /____/_/ /_/ /_/\__,_/
/____/ /____/
```
[](https://github.com/herrkaefer/anything2md/actions/workflows/ci.yml)
[](https://pypi.org/project/anything2md/)
[](https://pypi.org/project/anything2md/)
[](https://opensource.org/licenses/MIT)
Python package and CLI for converting URLs or local documents into Markdown using Cloudflare Markdown Conversion APIs.
## Install
From PyPI with `uv`:
```bash
uv add anything2md
```
Or from PyPI (pip):
```bash
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
```python
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")
# Browser Rendering advanced options for webpage URLs
result = mdconverter.transform(
"https://example.com",
url_strategy="browser",
wait_until="networkidle2",
reject_request_pattern=["/^.*\\.(css)$/", "/analytics/"],
)
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:
```bash
uv sync
```
```bash
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
uv run anything2md https://example.com --url-strategy browser --wait-until networkidle2 --reject-request-pattern '/^.*\.(css)$/' --reject-request-pattern '/analytics/'
```
## 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