ForHosting KIT · Daten & Dateien

HTML in Markdown umwandeln

KIT wandelt HTML-Code in Markdown um: Überschriften, Listen, Links und Tabellen werden in die entsprechende Markdown-Schreibweise übersetzt. Gedacht für alle, die eine bestehende HTML-Seite in eine README-Datei, ein Wiki oder ein Notiz-Tool überführen möchten, das Markdown statt HTML erwartet. Die Struktur des Ausgangstextes bleibt dabei erhalten.

● StabilKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

So funktioniert die Umwandlung

Sie fügen den HTML-Code ein, KIT erkennt die Struktur – Überschriften, Absätze, Listen, Links, Tabellen und Codeblöcke – und übersetzt sie in die entsprechende Markdown-Syntax. Rein optische Formatierungen wie Schriftfarben, die es in Markdown nicht gibt, werden dabei bewusst weggelassen, damit der Text danach überall lesbar bleibt. Bilder werden als Markdown-Bildverweis mit dem ursprünglichen Pfad übernommen, sodass sie nach dem Einfügen an neuer Stelle weiterhin eingebunden werden können.

Wofür sich das eignet

Beim Umzug einer Dokumentation von einer klassischen HTML-Website in ein Markdown-basiertes Wiki oder eine README-Datei auf einer Entwicklerplattform muss jede Seite neu formatiert werden. Statt jede Überschrift und Liste von Hand nachzubauen, übernimmt KIT die Übersetzung automatisch, Seite für Seite. Auch beim Verfassen einer technischen Dokumentation aus einer vorhandenen HTML-Vorlage spart dieser Schritt gegenüber dem manuellen Abtippen jeder einzelnen Zeile erheblich Zeit.

Grenzen, die Sie kennen sollten

Der HTML-Code darf bis zu 25 MB groß sein. Komplexe verschachtelte Tabellen oder eingebettete Skripte lassen sich nicht immer verlustfrei in Markdown abbilden, weil dieses Format bewusst einfacher aufgebaut ist als HTML; prüfen Sie solche Bereiche im Ergebnis. Auch spezielle Layout-Elemente wie mehrspaltige Bereiche gibt es in Markdown grundsätzlich nicht, sodass deren Inhalt zwar erhalten bleibt, die ursprüngliche Anordnung aber verloren geht.

Nach der Umwandlung

Der erzeugte Markdown-Text lässt sich direkt in ein Wiki, eine README-Datei oder ein Notiz-Tool einfügen. Soll der Text später wieder als HTML veröffentlicht werden, wandelt die umgekehrte KIT-Funktion ihn bei Bedarf zurück. So lässt sich ein und derselbe Inhalt je nach Bedarf beliebig oft zwischen beiden Formaten hin- und herbewegen, ohne ihn jedes Mal von Hand komplett neu zu schreiben oder zu formatieren.

Anwendungsfälle

Alte Produktseite ins Wiki überführen

Ein Entwickler in Hamburg übernimmt eine alte, in HTML geschriebene Produktdokumentation in ein neues, Markdown-basiertes internes Wiki und spart sich damit das manuelle Nachbauen jeder Seite.

Blog-Archiv für einen Umzug vorbereiten

Eine Agentur in Leipzig zieht einen Kundenblog auf eine neue, Markdown-basierte Plattform um und wandelt die vorhandenen HTML-Artikel vorab in Markdown um.

README aus alter Produktseite ableiten

Die Weber Metallbau GmbH erstellt aus einer bestehenden HTML-Produktbeschreibung eine README-Datei für die interne Dokumentation eines neuen Projekts.

Häufige Fragen

Was kostet die Umwandlung von HTML in Markdown?

Nutzen Sie die Web-Oberfläche, zahlen Sie nichts. Der Preis für die API-Anbindung liegt bei $0.002 pro Anfrage.

Gehen dabei Formatierungen verloren?

Rein optische Formatierungen wie Schriftfarben oder bestimmte Layout-Elemente gibt es in Markdown nicht und werden entsprechend weggelassen; die inhaltliche Struktur bleibt erhalten.

Verlässt mein HTML-Code dabei den Browser?

Solange Sie die Web-Oberfläche nutzen, ja: Ihr HTML-Code bleibt auf Ihrem Gerät, die Umwandlung läuft lokal ab.

Funktioniert das auch mit ganzen HTML-Seiten, nicht nur einzelnen Ausschnitten?

Ja, sowohl einzelne HTML-Ausschnitte als auch vollständige Seiten lassen sich umwandeln.

Wie groß darf der HTML-Code sein?

Bis zu 25 MB.

Brauche ich ein Konto?

Nein. Eine Anmeldung entfällt vollständig; lediglich bei der API-Nutzung berechnen wir den Preis pro Anfrage.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/data/html-to-markdown

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/data/html-to-markdown \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/data/html-to-markdown", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/html-to-markdown",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/html-to-markdown", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/html-to-markdown", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "input": "…"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.html_to_markdown",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

max_mb 25

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →

Im Browser ausführen – kostenlos