Cómo alojar tu propio editor de Markdown en hosting compartido, Docker o nginx

Un editor de Markdown autoalojado ofrece a tu equipo una única herramienta conocida en tu propio dominio: sin cuentas, sin suscripciones y sin depender de que el servicio de otro siga en línea. Si el editor es una aplicación web estática, alojarlo es tan sencillo como alojar unos cuantos archivos HTML: no hay base de datos que mantener, ni código de servidor que actualizar, y la carga para el servidor es casi nula.

Esta guía usa Markdown Preview Editor como ejemplo. Es gratuito y de código abierto (MIT), y los mismos pasos sirven para cualquier aplicación web estática.

¿Por qué alojar tu propio editor de Markdown?

• Tu dominio, tus reglas. El editor está disponible en una dirección que controlas tú, por ejemplo markdown.your-company.com, y funciona igual para todos los que lo usan.
• Nada que mantener. Un sitio estático no tiene backend, así que no hay parches de seguridad para código de servidor ni copias de seguridad de bases de datos.
• Los documentos se quedan en local. Markdown Preview Editor lo renderiza todo en el navegador del visitante. El servidor solo entrega los archivos de la aplicación: nunca recibe los documentos.
• Mantenerlo en marcha es gratis. Basta con cualquier plan de hosting compartido, un VPS pequeño o una plataforma de contenedores.

Qué necesitas

Cualquier servidor web que pueda servir archivos estáticos por HTTPS:

• hosting compartido con cPanel, Plesk o DirectAdmin (Apache o LiteSpeed),
• un servidor con Docker,
• nginx o Caddy en un VPS,
• o incluso tu propio ordenador para uso local.

En el servidor no hace falta PHP, Node.js ni base de datos.

Opción 1: hosting compartido (cPanel y similares)

Es la vía más rápida y no requiere línea de comandos.

1. Descarga el archivo del sitio. Consigue markdown-preview-editor-site.zip en la última versión. Contiene el sitio web ya compilado.
2. Elige la dirección. Usa tu dominio principal o crea un subdominio, como markdown.example.com, en el panel de control del hosting. Apunta la carpeta raíz de documentos (document root) del subdominio.
3. Activa HTTPS. La mayoría de los proveedores emiten certificados gratuitos automáticamente (AutoSSL o Let’s Encrypt). Comprueba que el certificado esté activo para el dominio o subdominio.
4. Sube y descomprime. Abre el Administrador de archivos (File Manager), ve a la raíz de documentos, sube el archivo zip y elige Extraer (Extract). Los archivos —incluido un .htaccess oculto— deben quedar directamente en la raíz de documentos, no en una subcarpeta.
5. Abre tu dominio. El editor está listo.

El .htaccess incluido redirige HTTP a HTTPS, establece cabeceras de seguridad y configura la caché en servidores Apache y LiteSpeed.

Opción 2: Docker

Si trabajas con contenedores, clona el repositorio e inicia el archivo Compose incluido:

bashgit clone https://github.com/ovasendin/markdown_preview_editor.git
cd markdown_preview_editor
PORT=8080 docker compose -f deploy/docker-compose.yml up -d --build

Abre http://localhost:8080, o el puerto que hayas elegido. La imagen compila el sitio y lo sirve con nginx y las mismas cabeceras de seguridad. Para un dominio público, coloca el contenedor detrás de tu proxy inverso habitual con HTTPS.

Opción 3: nginx

Compila el sitio (o descomprime el archivo de la versión) y copia los archivos a la raíz de tu web:

bashnpm ci && npm run build
sudo cp -r dist/* /var/www/markdown/

El repositorio incluye una configuración lista para usar en deploy/nginx.conf, con las cabeceras de seguridad y las reglas de caché. Lo esencial de la configuración de un sitio estático es breve:

nginxserver {
    listen 443 ssl;
    server_name markdown.example.com;
    # aquí van las líneas ssl_certificate y ssl_certificate_key

    root /var/www/markdown;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Recarga nginx con sudo nginx -s reload y abre el dominio.

Opción 4: Caddy

Caddy obtiene los certificados HTTPS automáticamente, lo que lo convierte en la opción más sencilla para un VPS:

bashSITE_ADDRESS=markdown.example.com caddy run --config deploy/Caddyfile

Antes, copia los archivos compilados a /srv; el Caddyfile incluido los sirve con las mismas cabeceras que las demás opciones.

Opción 5: ejecútalo en local

Para uso personal no necesitas ningún servidor:

bashnpm ci
npm run dev

Abre en tu navegador la dirección local que aparece en la consola.

Cómo mantenerlo actualizado

Actualizar un sitio estático consiste en sustituir sus archivos. Descarga el archivo de la nueva versión, descomprímelo sobre los archivos antiguos y recarga la página. Como los nombres de los archivos de la aplicación incluyen hashes de su contenido, los navegadores cargan la nueva versión sin problemas de caché obsoleta. Sigue el repositorio de GitHub (Watch → Custom → Releases) para recibir avisos de nuevas versiones.

Lista de comprobación tras el despliegue

• El sitio se abre por https:// y http:// redirige a él.
• Arrastra un archivo Markdown al editor: se abre en una pestaña nueva.
• Cambia el tema y el idioma en los ajustes.
• Exporta un documento de prueba a HTML para confirmar que las descargas funcionan.

Cuando tu editor esté en marcha, comparte la chuleta de Markdown con tu equipo y guarda en marcadores nuestras guías sobre cómo previsualizar Markdown y cómo exportar a HTML y PDF.