Como hospedar um editor de Markdown em hospedagem compartilhada, Docker ou nginx

Um editor de Markdown auto-hospedado dá à sua equipe uma ferramenta única e familiar no seu próprio domínio — sem contas, sem assinaturas e sem depender de que o serviço de outra pessoa continue no ar. Se o editor for um aplicativo web estático, hospedá-lo é tão simples quanto hospedar alguns arquivos HTML: não há banco de dados para manter, nenhum código de servidor para atualizar e quase nenhuma carga no servidor.

Este guia usa o Markdown Preview Editor como exemplo. Ele é gratuito e de código aberto (MIT), e os mesmos passos valem para qualquer aplicativo web estático.

Por que hospedar seu próprio editor de Markdown?

• Seu domínio, suas regras. O editor fica disponível em um endereço que você controla, por exemplo markdown.your-company.com, e funciona do mesmo jeito para todos que o usam.
• Nada para manter. Um site estático não tem backend, então não há patches de segurança para código de servidor nem backups de banco de dados.
• Os documentos ficam no computador local. O Markdown Preview Editor renderiza tudo no navegador do visitante. O servidor só entrega os arquivos do aplicativo — ele nunca recebe os documentos.
• Não custa nada para rodar. Qualquer plano de hospedagem compartilhada, uma VPS pequena ou uma plataforma de contêineres é suficiente.

Do que você precisa

Qualquer servidor web capaz de servir arquivos estáticos por HTTPS:

• hospedagem compartilhada com cPanel, Plesk ou DirectAdmin (Apache ou LiteSpeed),
• um servidor com Docker,
• nginx ou Caddy em uma VPS,
• ou até o seu próprio computador, para uso local.

Não é preciso PHP, Node.js nem banco de dados no servidor.

Opção 1: hospedagem compartilhada (cPanel e similares)

Este é o caminho mais rápido e não exige linha de comando.

1. Baixe o arquivo do site. Pegue o markdown-preview-editor-site.zip na versão mais recente. Ele contém o site já pronto.
2. Escolha o endereço. Use o seu domínio principal ou crie um subdomínio, como markdown.example.com, no painel de controle da hospedagem. Anote a pasta raiz (document root) do subdomínio.
3. Ative o HTTPS. A maioria das hospedagens emite certificados gratuitos automaticamente (AutoSSL ou Let’s Encrypt). Verifique se o certificado está ativo para o domínio ou subdomínio.
4. Envie e extraia. Abra o Gerenciador de arquivos, vá até a pasta raiz, envie o arquivo zip e escolha Extrair. Os arquivos — incluindo um .htaccess oculto — precisam ficar diretamente na pasta raiz, e não em uma subpasta.
5. Abra o seu domínio. O editor está pronto.

O .htaccess incluído redireciona HTTP para HTTPS, define cabeçalhos de segurança e configura o cache em servidores Apache e LiteSpeed.

Opção 2: Docker

Se você usa contêineres, clone o repositório e inicie o arquivo Compose incluído:

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

Abra http://localhost:8080 — ou a porta que você escolheu. A imagem gera o site e o serve com nginx e os mesmos cabeçalhos de segurança. Para um domínio público, coloque o contêiner atrás do seu proxy reverso de costume, com HTTPS.

Opção 3: nginx

Gere o site (ou extraia o arquivo da versão) e copie os arquivos para a raiz do seu servidor web:

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

O repositório contém uma configuração pronta em deploy/nginx.conf, com os cabeçalhos de segurança e as regras de cache. O essencial da configuração de um site estático é curto:

nginxserver {
    listen 443 ssl;
    server_name markdown.example.com;
    # as linhas ssl_certificate e ssl_certificate_key vão aqui

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

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

Recarregue o nginx com sudo nginx -s reload e abra o domínio.

Opção 4: Caddy

O Caddy obtém certificados HTTPS automaticamente, o que o torna a opção mais simples para uma VPS:

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

Primeiro copie os arquivos gerados para /srv; o Caddyfile incluído os serve com os mesmos cabeçalhos das outras opções.

Opção 5: rodar localmente

Para uso pessoal, você nem precisa de servidor:

bashnpm ci
npm run dev

Abra no navegador o endereço local exibido no terminal.

Como manter atualizado

Atualizar um site estático significa substituir os arquivos. Baixe o arquivo da nova versão, extraia-o por cima dos arquivos antigos e recarregue a página. Como os nomes dos arquivos do aplicativo incluem hashes do conteúdo, os navegadores pegam a nova versão sem cache desatualizado. Acompanhe o repositório no GitHub (Watch → Custom → Releases) para ser avisado sobre novas versões.

Checklist depois da implantação

• O site abre por https://, e http:// redireciona para ele.
• Arraste um arquivo Markdown para o editor — ele abre em uma nova aba.
• Troque o tema e o idioma nas configurações.
• Exporte um documento de teste para HTML para confirmar que os downloads funcionam.

Com o editor no ar, compartilhe o guia rápido de Markdown com a sua equipe e salve nos favoritos nossos guias sobre como visualizar Markdown e como exportar para HTML e PDF.