markdown-this
Extract the readable content of a URL and convert it to Markdown. The package also handles GitHub repositories and Markdown files through the GitHub API, and arXiv abstract pages through their HTML representation.
Installation
uv add markdown-this
Usage
from markdown_this import extract_main_content
title, markdown, fallback_text, intro = extract_main_content(
"https://example.com/article"
)
The source can also be a local HTML file (Path or path string) or raw HTML:
from pathlib import Path
from markdown_this import extract_main_content
title, markdown, fallback_text, intro = extract_main_content(Path("article.html"))
title, markdown, fallback_text, intro = extract_main_content("<html><p>...</p></html>")
extract_main_content returns the title, extracted Markdown, plain-text
fallback, and a short introduction suitable for a notification or preview.
The Markdown value starts with YAML front matter containing the metadata that
was found, such as title, author, url, and date.
For example:
---
title: An article
author: An author
url: https://example.com/article
date: 2026-08-06
---
Article content.
The package also installs a markdown-this command:
markdown-this https://example.com/article
markdown-this article.html
cat article.html | markdown-this -
The command writes the extracted Markdown to stdout. Its input may be a URL, an existing HTML path, or HTML read from stdin.
The lower-level fetchers and normalization helpers are available from the package modules when an application needs more control over the pipeline.
Development
uv run pytest packages/markdown-this/tests
uv run ruff check packages/markdown-this
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file markdown_this-0.1.5.tar.gz.
File metadata
- Download URL: markdown_this-0.1.5.tar.gz
- Upload date:
- Size: 8.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a041a71f4e76b7d9ac28e3076aa21bc09fc43271347b44cf9338f8c2fa26630b
|
|
| MD5 |
43eee5acba75eb0e0eedac0f4eee4aee
|
|
| BLAKE2b-256 |
e80ce4b07554523626c8ea2f1570ba55ecc107299e6a18280e298a25d874ae40
|
File details
Details for the file markdown_this-0.1.5-py3-none-any.whl.
File metadata
- Download URL: markdown_this-0.1.5-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
08d2f601348b3b51628f7c6f6b917e97ffc7d83bd1a2b5571f696eaa65bff733
|
|
| MD5 |
38f9b2e4eeb882e515516bcc6df7b3ea
|
|
| BLAKE2b-256 |
455d96b17eef3724de60e7ed29bd825b3211428cedd0e703ee79d8f9e0f86366
|
