CLI

Vue d’ensemble

Le CLI Web2MD vous permet de convertir n’importe quelle URL en Markdown propre directement depuis votre terminal. Envoyez le résultat à des LLM, traitez des listes d’URL en lot, ou ingérez du contenu dans votre coffre Obsidian — le tout sans ouvrir de navigateur.

npx web2md-cli https://example.com/article

Le CLI nécessite Node.js 18+. Exécutez node -v pour vérifier votre version.

Installation

Aucune installation nécessaire — exécutez simplement avec npx :

npx web2md-cli <url> [options]

Ou installez-le globalement pour un démarrage plus rapide :

npm install -g web2md-cli
web2md <url> [options]

Modes

Le CLI Web2MD fonctionne selon trois modes en fonction de votre configuration :

Local

Mode par défaut. Aucune clé API requise. Récupère et convertit les pages en local. Fonctionne pour la plupart des sites web publics.

Serveur

Avec clé API. Définissez WEB2MD_API_KEY pour débloquer Reddit, Fandom/Wikia et d’autres sites restreints nécessitant un traitement côté serveur.

Bridge

Avec l’option --bridge. Utilise votre extension Chrome pour récupérer des pages rendues en JS ou protégées par connexion, inaccessibles à la récupération statique.

Options

Option	Description
`--no-images`	Supprime les références d’images du résultat
`--no-links`	Supprime les hyperliens du résultat
`--meta`	Ajoute un en-tête YAML (title, source, wordCount, tokenCount, readingTime, date)
`--json`	Sortie au format JSON `{ markdown, metadata }`
`-o, --output <file>`	Écrit le résultat dans un fichier
`--output-dir <dir>`	Écrit chaque URL dans un fichier `.md` séparé
`--batch <file>`	Lit les URL depuis un fichier (une par ligne, `#` = commentaire)
`--vault <dir>`	Mode coffre Obsidian : enregistre dans `<dir>/raw/` et met à jour `<dir>/INDEX.md`
`--concurrency <n>`	Nombre max de récupérations parallèles (défaut : 3, max : 20)
`--bridge`	Utilise l’extension Chrome pour les sites rendus en JS ou protégés par connexion
`-q, --quiet`	Supprime les messages de progression

Commandes

Au-delà de la conversion d’URL, le CLI propose deux sous-commandes pour l’authentification et la synchronisation de la Bibliothèque :

Commande	Description
`web2md login`	S’authentifie une fois et enregistre votre clé API dans `~/.web2md/config.json`
`web2md sync [dir]`	Synchronise votre Bibliothèque Web2MD vers un répertoire local sous forme de fichiers Markdown

npx web2md-cli login

Démarre un flux d’autorisation par appareil basé sur le navigateur : le CLI ouvre https://web2md.org et affiche un code à approuver. Une fois approuvé, votre clé API est enregistrée dans ~/.web2md/config.json — plus besoin d’exporter WEB2MD_API_KEY dans chaque shell. Le serveur MCP lit depuis le même fichier, donc se connecter une fois ici authentifie aussi les appels d’outils MCP. Vous préférez coller directement une clé plutôt que passer par le flux navigateur ?

npx web2md-cli login --key

Cela demande une clé (w2m_...) sur l’entrée standard et l’enregistre de la même manière. Obtenez une clé depuis le tableau de bord.

sync

npx web2md-cli sync [dir] [--tag <t>] [--full]

Synchronise votre Bibliothèque — chaque page enregistrée via l’extension, le tableau de bord ou l’API — vers un répertoire local sous forme de fichiers Markdown avec en-tête YAML, organisés par tag. Nécessite d’être connecté (ou que WEB2MD_API_KEY soit défini).

Option	Description
`dir`	Répertoire cible (défaut : `./web2md-vault`)
`--tag <t>`	Synchronise uniquement les éléments avec ce tag
`--full`	Ignore le curseur incrémental et rescanne l’historique complet

La synchronisation est incrémentale par défaut : elle suit un curseur dans <dir>/.web2md-sync.json et ne récupère que les nouveaux éléments lors des exécutions suivantes. Pointez Obsidian (ou tout autre outil lisant du Markdown) vers le répertoire cible pour parcourir votre Bibliothèque sous forme de notes.

npx web2md-cli login
npx web2md-cli sync ~/Documents/Web2MD-Library

Variables d’environnement

Variable	Description
`WEB2MD_API_KEY`	Clé API (`w2m_xxx`) pour Reddit, les sites restreints, et `sync` — prioritaire sur `~/.web2md/config.json`
`WEB2MD_API_URL`	Remplace l’URL de base de l’API
`WEB2MD_EXTENSION_ID`	Remplace l’ID de l’extension Chrome pour le mode `--bridge`

Ajoutez-les à votre profil shell (~/.zshrc ou ~/.bashrc) pour qu’elles persistent entre les sessions :

export WEB2MD_API_KEY="w2m_your_key_here"

Exemples d’utilisation

Conversion basique

npx web2md-cli https://example.com/article

Affiche le Markdown sur la sortie standard.

Envoyer à un LLM

npx web2md-cli https://react.dev/learn/thinking-in-react | llm "Summarize this page"

npx web2md-cli https://docs.python.org/3/tutorial/classes.html | claude "Explain the key concepts"

Enregistrer dans un fichier

npx web2md-cli https://example.com/article -o article.md

npx web2md-cli https://example.com/article --meta -o article.md

L’option --meta ajoute un en-tête YAML avec le titre, l’URL source, le nombre de mots, le nombre de tokens, le temps de lecture et la date.

Traitement en lot depuis un fichier

Créez un fichier urls.txt :

# Research papers
https://arxiv.org/abs/2301.00001
https://arxiv.org/abs/2301.00002

# Blog posts
https://example.com/blog/post-1
https://example.com/blog/post-2

Puis exécutez :

npx web2md-cli --batch urls.txt --output-dir ./research --concurrency 5

Chaque URL est enregistrée dans un fichier .md séparé dans le répertoire ./research.

Ingestion dans un coffre Obsidian

npx web2md-cli --batch urls.txt --vault ~/Documents/MyVault

Cela enregistre chaque page dans ~/Documents/MyVault/raw/ et met à jour ~/Documents/MyVault/INDEX.md avec des liens vers toutes les pages converties.

Reddit avec clé API

export WEB2MD_API_KEY="w2m_your_key_here"
npx web2md-cli https://www.reddit.com/r/LocalLLaMA/comments/example

Reddit nécessite une clé API valide. Sans clé, les URL Reddit échoueront en raison des restrictions anti-bot de Reddit.

Mode Bridge

Utilisez l’extension Chrome pour gérer les pages rendues en JS ou protégées par connexion :

npx web2md-cli --bridge https://app.example.com/dashboard

Le mode Bridge nécessite que l’extension Chrome Web2MD soit installée et que Chrome soit en cours d’exécution. Le CLI communique avec l’extension via le protocole de messagerie native de Chrome.

Sortie JSON

npx web2md-cli --json https://example.com/article

Renvoie une sortie structurée :

{
  "markdown": "# Article Title\n\nContent here...",
  "metadata": {
    "title": "Article Title",
    "source": "https://example.com/article",
    "wordCount": 1250,
    "tokenCount": 1680,
    "readingTime": 5,
    "date": "2026-04-11T10:30:00.000Z"
  }
}

Utile pour une consommation programmatique ou pour envoyer à jq :

npx web2md-cli --json https://example.com/article | jq '.metadata.tokenCount'

Sites optimisés

Web2MD inclut des adaptateurs intégrés pour ces sites, produisant un résultat plus propre que la conversion générique :

Sites avec prise en charge optimisée

Wikipedia — extraction propre des articles, gestion des infobox
arXiv — résumés et métadonnées d’articles
Hacker News — fils de discussion avec commentaires
GitHub — Issues et Pull Requests
Stack Overflow — questions et réponses
dev.to — articles de blog
Medium — articles (contourne l’aperçu du paywall)
Substack — articles de newsletter
OpenAI Docs — pages de documentation
Docs basées sur Mintlify — sites de documentation construits sur Mintlify
Reddit — posts et commentaires (nécessite une clé API)

Workflows courants

Alimenter un agent IA en documentation

npx web2md-cli --batch docs-urls.txt --output-dir ./context --quiet

Pointez le répertoire de contexte de votre agent IA vers ./context pour des réponses ancrées.

Construire un corpus de recherche

npx web2md-cli --batch papers.txt --vault ~/Obsidian/Research --meta --concurrency 10

Crée un coffre de recherche indexé et consultable dans Obsidian.

Supprimer la mise en forme pour une entrée LLM

npx web2md-cli --no-images --no-links https://example.com/article | llm "Analyze this"

Supprime les images et les liens pour réduire la consommation de tokens lors de l’envoi à un LLM.

Premiers pas

Fonctionnalités principales

Avancé

Forfaits

Vue d’ensemble

Installation

Modes

Local

Serveur

Bridge

Options

Commandes

sync

Variables d’environnement

Exemples d’utilisation

Conversion basique

Envoyer à un LLM

Enregistrer dans un fichier

Traitement en lot depuis un fichier

Ingestion dans un coffre Obsidian

Reddit avec clé API

Mode Bridge

Sortie JSON

Sites optimisés

Workflows courants

​Vue d’ensemble

​Installation

​Modes

Local

Serveur

Bridge

​Options

​Commandes

​login

​sync

​Variables d’environnement

​Exemples d’utilisation

​Conversion basique

​Envoyer à un LLM

​Enregistrer dans un fichier

​Traitement en lot depuis un fichier

​Ingestion dans un coffre Obsidian

​Reddit avec clé API

​Mode Bridge

​Sortie JSON

​Sites optimisés

​Workflows courants

Vue d’ensemble

Installation

Modes

Options

Commandes

login

sync

Variables d’environnement

Exemples d’utilisation

Conversion basique

Envoyer à un LLM

Enregistrer dans un fichier

Traitement en lot depuis un fichier

Ingestion dans un coffre Obsidian

Reddit avec clé API

Mode Bridge

Sortie JSON

Sites optimisés

Workflows courants