Skip to main content

Übersicht

Mit der Web2MD CLI konvertieren Sie jede URL direkt von Ihrem Terminal aus in sauberes Markdown. Leiten Sie die Ausgabe per Pipe an LLMs weiter, verarbeiten Sie URL-Listen im Batch, oder übernehmen Sie Inhalte in Ihren Obsidian-Vault — alles ohne einen Browser zu öffnen.
Die CLI erfordert Node.js 18+. Führen Sie node -v aus, um Ihre Version zu prüfen.

Installation

Keine Installation nötig — einfach mit npx ausführen:
Oder global installieren für schnelleren Start:

Modi

Die Web2MD CLI arbeitet je nach Konfiguration in drei Modi:

Local

Standardmodus. Kein API-Schlüssel erforderlich. Ruft Seiten ab und konvertiert lokal. Funktioniert für die meisten öffentlichen Websites.

Server

Mit API-Schlüssel. Setzen Sie WEB2MD_API_KEY, um Reddit, Fandom/Wikia und andere eingeschränkte Seiten freizuschalten, die serverseitige Verarbeitung erfordern.

Bridge

Mit dem Flag --bridge. Nutzt Ihre Chrome-Erweiterung, um JS-gerenderte oder login-geschützte Seiten abzurufen, die statisches Fetching nicht erreichen kann.

Flags

Befehle

Neben der Konvertierung von URLs bietet die CLI zwei Subbefehle für Authentifizierung und Library-Sync:

login

Startet einen browserbasierten Device-Authorization-Flow: Die CLI öffnet https://web2md.org und zeigt einen Code zur Bestätigung an. Nach der Bestätigung wird Ihr API-Schlüssel in ~/.web2md/config.json gespeichert — Sie müssen WEB2MD_API_KEY nicht mehr in jeder Shell exportieren. Der MCP-Server liest aus derselben Datei, sodass eine einmalige Anmeldung hier auch MCP-Tool-Aufrufe authentifiziert. Möchten Sie stattdessen einen Schlüssel direkt einfügen, statt den Browser-Flow zu nutzen?
Dies fragt auf stdin nach einem Schlüssel (w2m_...) und speichert ihn auf dieselbe Weise. Holen Sie sich einen Schlüssel im Dashboard.

sync

Synchronisiert Ihre Library — jede Seite, die Sie über die Erweiterung, das Dashboard oder die API gespeichert haben — als Markdown-Dateien mit Frontmatter in ein lokales Verzeichnis, organisiert nach Tag. Erfordert eine Anmeldung (oder gesetztes WEB2MD_API_KEY). Die Synchronisierung ist standardmäßig inkrementell: Sie verfolgt einen Cursor in <dir>/.web2md-sync.json und ruft bei nachfolgenden Läufen nur neue Einträge ab. Richten Sie Obsidian (oder ein beliebiges Markdown-Tool) auf das Zielverzeichnis, um Ihre Library als Notizen zu durchsuchen.

Umgebungsvariablen

Fügen Sie diese Ihrem Shell-Profil hinzu (~/.zshrc oder ~/.bashrc), damit sie sitzungsübergreifend bestehen bleiben:

Anwendungsbeispiele

Einfache Konvertierung

Gibt Markdown auf stdout aus.

Per Pipe an ein LLM

In Datei speichern

Das Flag --meta stellt YAML-Frontmatter mit Titel, Quell-URL, Wortanzahl, Token-Anzahl, Lesezeit und Datum voran.

Batch aus Datei

Erstellen Sie eine Datei urls.txt:
Führen Sie dann aus:
Jede URL wird als separate .md-Datei im Verzeichnis ./research gespeichert.

Obsidian-Vault-Übernahme

Dies speichert jede Seite unter ~/Documents/MyVault/raw/ und aktualisiert ~/Documents/MyVault/INDEX.md mit Links zu allen konvertierten Seiten.

Reddit mit API-Schlüssel

Reddit erfordert einen gültigen API-Schlüssel. Ohne diesen schlagen Reddit-URLs aufgrund der Bot-Beschränkungen von Reddit fehl.

Bridge-Modus

Nutzen Sie die Chrome-Erweiterung, um JS-gerenderte oder login-geschützte Seiten zu verarbeiten:
Der Bridge-Modus erfordert eine installierte Web2MD Chrome-Erweiterung und ein laufendes Chrome. Die CLI kommuniziert über Chromes Native-Messaging-Protokoll mit der Erweiterung.

JSON-Ausgabe

Liefert eine strukturierte Ausgabe:
Nützlich für die programmatische Weiterverarbeitung oder zum Weiterleiten an jq:

Optimierte Seiten

Web2MD enthält integrierte Adapter für diese Seiten, die eine sauberere Ausgabe als die generische Konvertierung liefern:
  • Wikipedia — saubere Artikelextraktion, Infobox-Behandlung
  • arXiv — Paper-Abstracts und Metadaten
  • Hacker News — Threads mit Kommentaren
  • GitHub — Issues und Pull Requests
  • Stack Overflow — Fragen und Antworten
  • dev.to — Blogbeiträge
  • Medium — Artikel (umgeht die Paywall-Vorschau)
  • Substack — Newsletter-Beiträge
  • OpenAI Docs — Dokumentationsseiten
  • Mintlify-basierte Docs — auf Mintlify aufgebaute Dokumentations-Websites
  • Reddit — Beiträge und Kommentare (erfordert API-Schlüssel)

Gängige Workflows

Richten Sie das Kontextverzeichnis Ihres AI-Agenten auf ./context, um fundierte Antworten zu erhalten.
Erstellt einen indizierten, durchsuchbaren Research-Vault in Obsidian.
Entfernt Bilder und Links, um den Token-Verbrauch beim Weiterleiten an LLMs zu reduzieren.