Cómo publicar Markdown de Typora como sitio web

Actualizado

Typora es una de las formas más agradables de escribir Markdown: renderiza mientras escribes y guarda archivos .md planos. Lo que no tiene es una forma de poner esos archivos en línea. Exporta a HTML y PDF, pero publicar un sitio queda por tu cuenta.

Esta guía convierte una carpeta de documentos de Typora en un sitio web con Sentilis. Tus archivos se quedan exactamente donde están; no hay paso de exportación.

1. Abre una carpeta en Typora

Elige una carpeta para todo lo que vas a publicar — por ejemplo my-content/ — y ábrela en Typora (File → Open Folder) para que la barra lateral muestre tus archivos. Dentro, crea una carpeta press/ para posts y documentación:

my-content/
└── press/
    ├── hola-mundo.md
    └── un-viaje-a-lisboa/
        ├── un-viaje-a-lisboa.md
        └── attachments/
            ├── cover.jpg
            └── tranvia.jpg

Un post solo de texto puede ser un archivo .md. Un post con imágenes locales tiene su propia carpeta con una carpeta attachments/ dentro.

2. Manda las imágenes a attachments/ automáticamente

Sentilis sube las imágenes locales desde la carpeta attachments/ junto a cada documento. Typora puede ponerlas ahí por ti:

  1. Abre Preferences → Image.
  2. En la acción para las imágenes insertadas, elige copiar la imagen a una carpeta personalizada y define la carpeta como ./attachments.

Desde ahora, cada imagen que pegues o arrastres a un documento queda en attachments/, y el Markdown apunta a ella:

![Tranvía 28](./attachments/tranvia.jpg "Tranvía 28, Alfama")

Configúralo en las preferencias globales de Typora y no por documento. La opción por documento escribe un campo typora-copy-images-to en el front matter del documento, que Sentilis marca como campo desconocido.

3. Agrega un bloque de ajustes

Escribe --- en la primera línea de un documento y Typora abre un bloque de front matter. Agrega algunos ajustes:

---
name: Un viaje a Lisboa
category: Viajes
tags: viajes, portugal
---

name se convierte en el título de la página; sin él, se usa el nombre del archivo. Un cover.jpg en attachments/ se convierte en la imagen que se muestra al compartir la página.

4. Publica

Instala el CLI de Sentilis una vez, inicia sesión y sincroniza la carpeta:

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

Cada documento dentro de press/ ya es una página en tu perfil de Sentilis.

5. Sigue escribiendo

Edita en Typora, guarda y ejecuta sentilis sync de nuevo. Las páginas conservan su URL mientras su slug no cambie. Usa status: draft para lo que está en progreso: los borradores no se ven en tu sitio.

Para revisar todo sin subir nada, ejecuta sentilis sync ./my-content --dry-run.

Qué más puede contener la carpeta

Junto a press/, la misma carpeta puede contener tu bio (bio/), productos y servicios (market/), membresías (prime/) y un portafolio visual (gallery/) — todo escrito en Typora.

Publica desde Typora →

Sigue leyendo

Guías →

Tu Markdown ya es tu contenido. Ahora dale un hogar en la web.

Publica tu Markdown →