Cómo crear un sitio web a partir de archivos Markdown

Markdown es texto plano con algunas convenciones para títulos, listas, enlaces e imágenes. Se lee tal cual, funciona en cualquier editor y se convierte limpiamente a HTML — lo que lo hace un origen natural para un sitio web.

Esta guía toma una carpeta de archivos Markdown y la publica como sitio web con Sentilis, sin build ni hosting que administrar.

1. Organiza la carpeta

Agrupa los archivos según lo que serán en tu sitio:

my-content/
├── bio/
│   └── es.md                  ← tu página "sobre mí"
├── press/
│   ├── hola-mundo.md          ← un post
│   └── guia/
│       ├── index.md           ← una página de documentación…
│       ├── instalacion.md     ← …y sus secciones
│       └── attachments/
│           └── cover.png
└── market/
    └── llamada-de-una-hora.md ← un servicio que se puede comprar

• press/ contiene posts, artículos y documentación.
• bio/ contiene una página de perfil, un archivo por idioma.
• market/ contiene productos y servicios, con checkout incluido.

También existen prime/ para membresías mensuales y gallery/ para obra visual.

2. Dale a cada archivo un bloque de ajustes

Un pequeño bloque de ajustes al inicio — el frontmatter — le dice a Sentilis cómo mostrar el archivo:

---
name: Hola, mundo
category: Notas
status: published
---

# Hola, mundo

Mi primera página, escrita en Markdown plano.

Todos los campos son opcionales: sin name, se usa el nombre del archivo. El resto del archivo es tu contenido, escrito en Markdown normal.

3. Agrega imágenes de la forma correcta

Las imágenes locales necesitan una carpeta: pon la página en su propia carpeta con una carpeta attachments/ al lado, y enlaza las imágenes desde ahí.

![Diagrama de instalación](./attachments/diagrama.png "Cómo encajan las piezas")

Las imágenes remotas con URL https:// funcionan en cualquier lugar, incluso en páginas de un solo archivo.

4. Publica

Instala el CLI de Sentilis, inicia sesión con el token de tu perfil y sincroniza la carpeta:

npm i -g @sentilis/cli
sentilis auth login <tu-token>
sentilis sync ./my-content

Ejecuta sentilis sync de nuevo después de cada cambio. Las páginas conservan su URL mientras su slug no cambie.

5. Automatízalo (opcional)

Si my-content/ vive en un repositorio Git, los mismos comandos pueden correr en CI en cada push a tu rama principal. Así tu sitio se actualiza cada vez que haces merge, con los archivos Markdown como única fuente de verdad.

¿Qué editor?

Cualquier editor que guarde archivos .md sirve. Obsidian tiene un plugin de Sentilis que publica con un clic derecho; Typora y VS Code guardan archivos Markdown que puedes publicar tal cual. Las apps que guardan las notas en su propia biblioteca pueden exportarlas como Markdown primero.

Convierte tus archivos Markdown en un sitio web →