# Markdown Extract

> markdown-extract Skill

- Skill: `johnalbertini14-glitch/markdown-extract` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/markdown-extract`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/markdown-extract/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/johnalbertini14-glitch/markdown-extract

---

# markdown-extract Skill

Extract clean markdown from any URL using the markdown.new API.

## Description

This skill converts web pages to clean markdown format using the markdown.new API. It supports multiple extraction methods and handles errors gracefully.

## Usage

```
!markdown-extract <url> [method]
```

### Arguments

- `url` (required): The URL to extract markdown from
- `method` (optional): Extraction method - `auto`, `ai`, or `browser`. Default: `auto`

### Examples

```bash
# Extract using default method (auto)
!markdown-extract https://example.com

# Extract using AI method
!markdown-extract https://example.com ai

# Extract using browser method
!markdown-extract https://example.com browser
```

## API

- GET `https://markdown.new/<url>` - Returns clean markdown (auto method)
- POST with JSON body `{url: "...", method: "browser|ai"}` - Specific extraction method

## Methods

- **auto**: Content negotiation with `Accept: text/markdown` header (fastest, default)
- **ai**: Cloudflare Workers AI `toMarkdown()` conversion
- **browser**: Headless browser rendering for JS-heavy pages (slowest but most complete)

## Error Handling

- Invalid URL: Returns error message
- Network failure: Returns retryable error
- API error: Returns error details
- Cloudflare block detection and fallback handling

