CLI

Descripción general

La CLI de Web2MD te permite convertir cualquier URL a Markdown limpio directamente desde tu terminal. Envía la salida a LLMs, procesa listas de URLs en lote, o incorpora contenido en tu bóveda de Obsidian — todo sin abrir un navegador.

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

La CLI requiere Node.js 18+. Ejecuta node -v para comprobar tu versión.

Instalación

No se necesita instalación — simplemente ejecuta con npx:

npx web2md-cli <url> [options]

O instala globalmente para un arranque más rápido:

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

Modos

La CLI de Web2MD opera en tres modos según tu configuración:

Local

Modo predeterminado. No requiere clave de API. Obtiene páginas y las convierte localmente. Funciona para la mayoría de los sitios web públicos.

Servidor

Con clave de API. Define WEB2MD_API_KEY para desbloquear Reddit, Fandom/Wikia y otros sitios restringidos que requieren manejo del lado del servidor.

Bridge

Con la opción --bridge. Usa tu extensión de Chrome para obtener páginas renderizadas con JS o protegidas por login a las que la obtención estática no puede acceder.

Opciones

Opción	Descripción
`--no-images`	Elimina las referencias a imágenes del resultado
`--no-links`	Elimina los hipervínculos del resultado
`--meta`	Añade frontmatter en YAML (title, source, wordCount, tokenCount, readingTime, date)
`--json`	Muestra el resultado como JSON `{ markdown, metadata }`
`-o, --output <file>`	Escribe el resultado en un archivo
`--output-dir <dir>`	Escribe cada URL en un archivo `.md` separado
`--batch <file>`	Lee URLs desde un archivo (una por línea, `#` = comentario)
`--vault <dir>`	Modo bóveda de Obsidian: guarda en `<dir>/raw/` y actualiza `<dir>/INDEX.md`
`--concurrency <n>`	Número máximo de solicitudes en paralelo (predeterminado: 3, máximo: 20)
`--bridge`	Usa la extensión de Chrome para sitios renderizados con JS o protegidos por login
`-q, --quiet`	Suprime los mensajes de progreso

Comandos

Además de convertir URLs, la CLI tiene dos subcomandos para autenticación y sincronización de la Library:

Comando	Descripción
`web2md login`	Autentícate una vez y guarda tu clave de API en `~/.web2md/config.json`
`web2md sync [dir]`	Sincroniza tu Library de Web2MD con un directorio local como archivos Markdown

npx web2md-cli login

Inicia un flujo de autorización de dispositivo basado en el navegador: la CLI abre https://web2md.org y muestra un código para aprobar. Una vez aprobado, tu clave de API se guarda en ~/.web2md/config.json — sin necesidad de exportar WEB2MD_API_KEY en cada shell. El servidor MCP lee del mismo archivo, así que iniciar sesión aquí una vez también autentica las llamadas a herramientas MCP. ¿Prefieres pegar una clave directamente en lugar del flujo del navegador?

npx web2md-cli login --key

Esto solicita una clave (w2m_...) por stdin y la guarda de la misma forma. Obtén una clave desde el panel.

sync

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

Sincroniza tu Library — cada página que has guardado vía la extensión, el panel o la API — con un directorio local como archivos Markdown con frontmatter, organizados por etiqueta. Requiere haber iniciado sesión (o tener definida WEB2MD_API_KEY).

Opción	Descripción
`dir`	Directorio de destino (predeterminado: `./web2md-vault`)
`--tag <t>`	Sincroniza solo los elementos con esta etiqueta
`--full`	Ignora el cursor incremental y vuelve a escanear todo el historial

La sincronización es incremental por defecto: registra un cursor en <dir>/.web2md-sync.json y solo trae elementos nuevos en ejecuciones posteriores. Apunta Obsidian (o cualquier herramienta que lea Markdown) al directorio de destino para explorar tu Library como notas.

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

Variables de entorno

Variable	Descripción
`WEB2MD_API_KEY`	Clave de API (`w2m_xxx`) para Reddit, sitios restringidos y `sync` — tiene prioridad sobre `~/.web2md/config.json`
`WEB2MD_API_URL`	Sobrescribe la URL base de la API
`WEB2MD_EXTENSION_ID`	Sobrescribe el ID de la extensión de Chrome para el modo `--bridge`

Añade estas variables a tu perfil de shell (~/.zshrc o ~/.bashrc) para que persistan entre sesiones:

export WEB2MD_API_KEY="w2m_your_key_here"

Ejemplos de uso

Conversión básica

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

Imprime Markdown en stdout.

Enviar a 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"

Guardar en archivo

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

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

La opción --meta antepone frontmatter en YAML con título, URL de origen, recuento de palabras, recuento de tokens, tiempo de lectura y fecha.

Lote desde archivo

Crea un archivo 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

Luego ejecuta:

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

Cada URL se guarda como un archivo .md separado en el directorio ./research.

Incorporación a una bóveda de Obsidian

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

Esto guarda cada página en ~/Documents/MyVault/raw/ y actualiza ~/Documents/MyVault/INDEX.md con enlaces a todas las páginas convertidas.

Reddit con clave de API

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

Reddit requiere una clave de API válida. Sin ella, las URLs de Reddit fallarán debido a las restricciones anti-bot de Reddit.

Modo bridge

Usa la extensión de Chrome para manejar páginas renderizadas con JS o protegidas por login:

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

El modo bridge requiere que la extensión de Chrome de Web2MD esté instalada y que Chrome esté en ejecución. La CLI se comunica con la extensión mediante el protocolo de native messaging de Chrome.

Salida JSON

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

Devuelve una salida estructurada:

{
  "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"
  }
}

Útil para consumo programático o para enviar a jq:

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

Sitios optimizados

Web2MD incluye adaptadores integrados para estos sitios, produciendo un resultado más limpio que la conversión genérica:

Sitios con soporte optimizado

Wikipedia — extracción limpia de artículos, manejo de infoboxes
arXiv — resúmenes y metadatos de artículos
Hacker News — hilos con comentarios
GitHub — Issues y Pull Requests
Stack Overflow — preguntas y respuestas
dev.to — entradas de blog
Medium — artículos (evita la vista previa del paywall)
Substack — publicaciones de newsletter
OpenAI Docs — páginas de documentación
Sitios de documentación basados en Mintlify — sitios de documentación construidos sobre Mintlify
Reddit — publicaciones y comentarios (requiere clave de API)

Flujos de trabajo comunes

Alimentar documentación a un agente de IA

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

Apunta el directorio de contexto de tu agente de IA a ./context para obtener respuestas fundamentadas.

Construir un corpus de investigación

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

Crea una bóveda de investigación indexada y consultable en Obsidian.

Eliminar formato para entrada a LLM

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

Elimina imágenes y enlaces para reducir el uso de tokens al enviar a LLMs.

Primeros pasos

Funciones principales

Avanzado

Planes

Descripción general

Instalación

Modos

Local

Servidor

Bridge

Opciones

Comandos

sync

Variables de entorno

Ejemplos de uso

Conversión básica

Enviar a un LLM

Guardar en archivo

Lote desde archivo

Incorporación a una bóveda de Obsidian

Reddit con clave de API

Modo bridge

Salida JSON

Sitios optimizados

Flujos de trabajo comunes

​Descripción general

​Instalación

​Modos

Local

Servidor

Bridge

​Opciones

​Comandos

​login

​sync

​Variables de entorno

​Ejemplos de uso

​Conversión básica

​Enviar a un LLM

​Guardar en archivo

​Lote desde archivo

​Incorporación a una bóveda de Obsidian

​Reddit con clave de API

​Modo bridge

​Salida JSON

​Sitios optimizados

​Flujos de trabajo comunes

Descripción general

Instalación

Modos

Opciones

Comandos

login

sync

Variables de entorno

Ejemplos de uso

Conversión básica

Enviar a un LLM

Guardar en archivo

Lote desde archivo

Incorporación a una bóveda de Obsidian

Reddit con clave de API

Modo bridge

Salida JSON

Sitios optimizados

Flujos de trabajo comunes