Installation And Usage

Installation

uv add markdown-this

Python API

from markdown_this import extract_main_content

title, markdown, fallback_text, intro = extract_main_content(
    "https://example.com/article"
)

The source can be a URL, Path, path string, or raw HTML string.

is_html_source identifies raw HTML that starts with a complete document or a structural fragment: article, body, main, section, or div. It returns false for Markdown or prose that merely contains HTML later in the text.

CLI

uvx markdown-this https://example.com/article
uvx markdown-this article.html
cat article.html | uvx markdown-this -

The command writes Markdown to stdout.

Development

uv run pytest packages/markdown-this/tests
uv run ruff check packages/markdown-this