Przejdź do treści
Biblioteka skilli
Programowanie · Konwersja i formaty

html-to-markdown-extracting-metadata

/html-to-markdown-extracting-metadata

Wyciąga metadane z HTML, takie jak tytuł, opis, język, Open Graph, JSON-LD, nagłówki, linki i obrazy, w formacie JSON.

Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

95/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść30 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
0
Komentarze HTML
1
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Wyciąga metadane z HTML, takie jak tytuł, opis, język, Open Graph, JSON-LD, nagłówki, linki i obrazy, w formacie JSON.

Oryginalny opis (EN)

Use when extracting metadata from HTML — title, description, language, Open Graph, JSON-LD / Microdata / RDFa, headers, links, and images. Covers the --json output shape and the --extract-metadata flag.

Jak działa

  1. Get all metadata
  2. Metadata sub-fields
  3. Metadata flag
  4. Common queries
  5. Programmatic access
Sekcje z nagłówków SKILL.md, w oryginale · 109 linii, 465 słów
Podgląd SKILL.md
---
description: Use when extracting metadata from HTML — title, description, language, Open Graph, JSON-LD / Microdata / RDFa, headers, links, and images. Covers the --json output shape and the --extract-metadata flag.
name: html-to-markdown-extracting-metadata
---

<!--
AI-RULEZ :: GENERATED FILE — DO NOT EDIT
Content-Hash: blake3:008ee34eae3d73ceed0d8a9c7fdb8ae8562558ccef3be60bac93f03dbf362e29
Source-Hash: blake3:4b8ba5033e49c69ed09bbaaceb7ef28a76b6ac18a031a3761951628b493e0c93
Schema-Version: v1
-->

# Extracting metadata

Use this when the user wants structured metadata out of HTML rather than (or in
addition to) the Markdown body — page title, description, language, Open Graph
tags, structured data, the heading outline, links, or image references.

Metadata lives in `result.metadata` and is surfaced on the CLI through
`--json`. On the CLI, metadata extraction is **opt-in**: pass
`--extract-metadata` alongside `--json`, otherwise `result.metadata` comes back
empty (`document.title` is null, `headers`/`links`/`images`/`structured_data`
are `[]`). The library `convert()` call extracts metadata by default
(`extract_metadata=True`) — that default is a property of the API, not the CLI.
There are no per-field extraction flags: `--extract-metadata` populates all
sub-fields below at once.

## Get all metadata

```bash
html-to-markdown --json --extract-metadata input.html | jq '.metadata'

# Extraction-only (skip the Markdown body)
html-to-markdown --json --extract-metadata --no-content input.html | jq '.metadata'
```

## Metadata sub-fields

```json
{
  "metadata": {
    "document": { "title": "...", "description": "...", "language": "en", "open_graph": {"title": "..."} },
    "headers": [ { "level": 1, "text": "Main Heading" } ],
    "links":   [ { "href": "https://example.com", "link_type": "external" } ],
    "images":  [ { "src": "photo.jpg", "alt": "A photo", "image_type": "external" } ],
    "structured_data": [ /* JSON-LD, Microdata, RDFa blocks */ ]
  }
}
```

## Metadata flag

There is one metadata flag: `--extract-metadata`. With `--json` set it populates
all sub-fields above (`document`, `headers`, `links`, `images`,
`structured_data`) under `result.metadata` — select what you need with `jq`.

| Flag | Effect |
| ---- | ------ |
| `--extract-metadata` | With `--json`: populate `result.metadata`. In plain-text mode (no `--json`): prepend title + meta tags as a YAML frontmatter block (`---`-delimited) at the top of the Markdown output |

```bash
# Pull just the document-level metadata and the heading outline
html-to-markdown --json --extract-metadata --no-content input.html \
  | jq '{title: .metadata.document.title, lang: .metadata.document.language, outline: [.metadata.headers[].text]}'
```

## Common queries

```bash
# Title + canonical language
html-to-markdown --json --extract-metadata input.html | jq '{title: .metadata.document.title, lang: .metadata.document.language}'

# External links only
html-to-markdown --json --extract-metadata input.html | jq '[.metadata.links[] | select(.link_type == "external") | .href]'

# Open Graph card
html-to-markdown --json --extract-metadata input.html | jq '.metadata.document.open_graph'

# JSON-LD blocks
html-to-markdown --json --extract-metadata input.html | jq '.metadata.structured_data'
```

## Programmatic access

```python
from html_to_markdown import convert

html = """
<html lang="en">
<head><title>My Article</title></head>
<body>
<h1>Main Heading</h1>
<a href="https://example.com">External link</a>
<img src="photo.jpg" alt="A photo">
</body>
</html>
"""
result = convert(html)
meta = result.metadata
print(meta.document.title)        # "My Article"
print(meta.document.language)     # "en"
print(meta.headers[0].text)       # "Main Heading"
print(meta.links[0].link_type)    # "external"
print(meta.images[0].alt)         # "A photo"
```

Metadata is available from the single `convert()` call in Python, Rust, Go,
Ruby, and Elixir; in TypeScript read it off the returned result object. In Rust
it requires the `metadata` feature (on by default).

See `references/cli-reference.md` (Metadata section) and
`references/configuration.md` for field details.
Pliki w paczce (8)
  • SKILL.md 4 KB
  • index.md 1 KB
  • references/cli-reference.md 19 KB
  • references/configuration.md 19 KB
  • references/other-bindings.md 12 KB
  • references/python-api.md 8 KB
  • references/rust-api.md 11 KB
  • references/typescript-api.md 7 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · xberg-io/html-to-markdown95MIT
xberg-io/html-to-markdown95MIT

Migawka bazy z 13.11.2026 · wersja paczki 1497064d64ba (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100structured-data-validator
    Waliduje dane strukturalne zapisane w JSON-LD, Microdata lub RDFa w kodzie źródłowym strony.
  • 100html-to-markdown-using-the-mcp-server
    Konwertuje HTML na Markdown oraz wyciąga metadane i tabele przez narzędzia serwera MCP html-to-markdown zamiast CLI, w tym automatycznie instalowany launcher.
  • 100fixing-metadata
    Audytuje i poprawia metadane HTML: tytuły, opisy, adresy canonical, tagi Open Graph, karty Twitter, favicony, JSON-LD i dyrektywy robots.
  • 100html-to-markdown-using-the-mcp-server
    Konwertuje HTML na Markdown i wyciąga metadane oraz tabele przez serwer MCP html-to-markdown, zamiast uruchamiać CLI.
  • 100scrape-webpage
    Pobiera źródłową stronę w potoku importu do AEM Edge Delivery Services: scrapuje treść, wyciąga metadane, pobiera obrazy i zwraca JSON analizy z oczyszczonym HTML.
  • 95tree-sitter-language-pack-extracting-code-structure
    Wyciąga z pliku źródłowego strukturę kodu: funkcje, klasy, importy, eksporty, docstringi i błędy składni w formacie JSON.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.