Cómo publicar Markdown desde VS Code como sitio web

VS Code es donde mucha gente ya escribe sus READMEs, changelogs y documentación. Edita y previsualiza Markdown sin extensiones, y su terminal integrada está a un atajo de distancia. Eso lo convierte en un lugar natural para escribir un sitio web — y para publicarlo.

Esta guía toma Markdown escrito en VS Code y lo publica con el CLI de Sentilis, sin salir del editor.

1. Prepara la carpeta de contenido

Abre una carpeta en VS Code (File → Open Folder) — una nueva, o una carpeta dentro de un repositorio existente:

my-content/
├── bio/
│   └── es.md                  ← tu página de perfil
└── press/
    ├── notas-de-version-2026-09.md
    └── primeros-pasos/
        ├── index.md           ← página principal
        ├── instalacion.md     ← sección
        └── attachments/
            └── cover.png

press/ contiene posts y documentación. Una carpeta con un index.md es una entrada, y cada otro .md junto a él se convierte en una sección.

2. Escribe y previsualiza

Cada archivo empieza con un pequeño bloque de ajustes:

---
name: Primeros pasos
category: Documentación
status: draft
---

# Primeros pasos

Empieza por la [guía de instalación](./instalacion.md).

Abre la vista previa integrada con Markdown: Open Preview to the Side para ver la página renderizada junto al código. Los enlaces entre páginas de una misma entrada usan el nombre del archivo, como ./instalacion.md; las imágenes viven en la carpeta attachments/ de la entrada.

3. Instala el CLI e inicia sesión

Abre la terminal integrada (Terminal → New Terminal) y ejecuta:

npm i -g @sentilis/cli
sentilis auth login <tu-token>
sentilis auth whoami

4. Valida y después publica

Revisa cada entrada sin subir nada:

sentilis sync ./my-content --dry-run

Cuando todo pase, cambia status: draft a published en los archivos que quieras publicar, y publica:

sentilis sync ./my-content

Ejecuta el mismo comando después de cada cambio. Las páginas conservan su URL mientras su slug no cambie.

5. Conviértelo en una tarea (opcional)

Para publicar sin escribir el comando, agrega una tarea de VS Code en .vscode/tasks.json:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Sentilis: sync",
      "type": "shell",
      "command": "sentilis sync ./my-content --strict"
    }
  ]
}

Ejecútala con Tasks: Run Task. --strict aborta toda la ejecución si alguna entrada tiene un problema, así nada queda medio publicado.

6. Publica desde CI

Si la carpeta vive en un repositorio Git, deja que CI publique en cada merge. Mira publicar con GitHub Actions para un workflow completo, y docs as code para el proceso de revisión alrededor.

Escribe en VS Code, publica desde la terminal →