Markdown Editörü Paylaşımlı Hosting, Docker veya nginx Üzerinde Nasıl Barındırılır?

Kendi sunucunuzda barındırdığınız bir Markdown editörü, ekibinize kendi alan adınızda tek ve tanıdık bir araç sunar — hesap yok, abonelik yok ve başkasının hizmetinin ayakta kalmasına bağımlılık yok. Editör bir statik web uygulaması ise onu barındırmak birkaç HTML dosyasını barındırmak kadar kolaydır: bakımı yapılacak bir veritabanı, güncellenecek sunucu tarafı kod yoktur ve sunucuya neredeyse hiç yük binmez.

Bu rehber örnek olarak Markdown Preview Editor’ı kullanıyor. Ücretsiz ve açık kaynaklıdır (MIT); aynı adımlar herhangi bir statik web uygulaması için de geçerlidir.

Neden kendi Markdown editörünüzü barındırmalısınız?

• Alan adı sizin, kurallar sizin. Editör, kontrolünüzdeki bir adreste, örneğin markdown.your-company.com üzerinde çalışır ve onu kullanan herkes için aynı şekilde işler.
• Bakım gerektirmez. Statik bir sitenin arka ucu yoktur; bu yüzden sunucu kodu için güvenlik yaması da veritabanı yedeği de yoktur.
• Belgeler yerel kalır. Markdown Preview Editor her şeyi ziyaretçinin tarayıcısında işler. Sunucu yalnızca uygulamanın dosyalarını iletir — belgeleri asla almaz.
• Çalıştırması ücretsizdir. Herhangi bir paylaşımlı hosting paketi, küçük bir VPS ya da bir konteyner platformu yeterlidir.

Neye ihtiyacınız var?

Statik dosyaları HTTPS üzerinden sunabilen herhangi bir web sunucusu:

• cPanel, Plesk veya DirectAdmin’li paylaşımlı hosting (Apache veya LiteSpeed),
• Docker kurulu bir sunucu,
• bir VPS üzerinde nginx veya Caddy,
• ya da yerel kullanım için kendi bilgisayarınız.

Sunucuda PHP, Node.js ya da veritabanı gerekmez.

1. seçenek: Paylaşımlı hosting (cPanel ve benzerleri)

Bu en hızlı yoldur ve komut satırı gerektirmez.

1. Site arşivini indirin. markdown-preview-editor-site.zip dosyasını en son sürümden alın. Arşiv, derlenmiş ve kullanıma hazır web sitesini içerir.
2. Adresi seçin. Ana alan adınızı kullanın ya da hosting kontrol panelinde markdown.example.com gibi bir alt alan adı oluşturun. Alt alan adının belge kökü (document root) klasörünü not edin.
3. HTTPS’i etkinleştirin. Çoğu hosting sağlayıcısı ücretsiz sertifikaları otomatik olarak verir (AutoSSL veya Let’s Encrypt). Sertifikanın alan adı veya alt alan adı için etkin olduğundan emin olun.
4. Yükleyin ve çıkarın. Dosya Yöneticisi’ni açın, belge köküne gidin, zip dosyasını yükleyin ve Çıkart (Extract) seçeneğini seçin. Gizli .htaccess dahil tüm dosyalar bir alt klasörde değil, doğrudan belge kökünde olmalıdır.
5. Alan adınızı açın. Editör hazır.

Birlikte gelen .htaccess, Apache ve LiteSpeed sunucularında HTTP’yi HTTPS’e yönlendirir, güvenlik başlıklarını ayarlar ve önbelleği yapılandırır.

2. seçenek: Docker

Konteyner kullanıyorsanız depoyu klonlayın ve birlikte gelen Compose dosyasını başlatın:

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

http://localhost:8080 adresini açın — ya da seçtiğiniz bağlantı noktasını. İmaj siteyi derler ve aynı güvenlik başlıklarıyla nginx üzerinden sunar. Herkese açık bir alan adı için konteyneri, HTTPS’li her zamanki ters vekil sunucunuzun (reverse proxy) arkasına yerleştirin.

3. seçenek: nginx

Siteyi derleyin (ya da sürüm arşivini çıkarın) ve dosyaları web kök dizininize kopyalayın:

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

Depo, güvenlik başlıkları ve önbellek kurallarıyla birlikte deploy/nginx.conf içinde hazır bir yapılandırma barındırır. Statik bir site yapılandırmasının özü kısadır:

nginxserver {
    listen 443 ssl;
    server_name markdown.example.com;
    # ssl_certificate ve ssl_certificate_key satırları buraya gelir

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

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

nginx’i sudo nginx -s reload ile yeniden yükleyin ve alan adını açın.

4. seçenek: Caddy

Caddy HTTPS sertifikalarını otomatik olarak alır; bu da onu bir VPS için en basit seçenek yapar:

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

Önce derlenmiş dosyaları /srv dizinine kopyalayın; birlikte gelen Caddyfile onları diğer seçeneklerle aynı başlıklarla sunar.

5. seçenek: Yerel olarak çalıştırın

Kişisel kullanım için bir sunucuya hiç ihtiyacınız yok:

bashnpm ci
npm run dev

Ekrana yazdırılan yerel adresi tarayıcınızda açın.

Güncel tutmak

Statik bir siteyi güncellemek, dosyalarını değiştirmek demektir. Yeni sürüm arşivini indirin, eski dosyaların üzerine çıkarın ve sayfayı yeniden yükleyin. Uygulamanın dosya adları içerik hash’leri içerdiğinden tarayıcılar eski önbelleğe takılmadan yeni sürümü alır. Yeni sürümlerden haberdar olmak için GitHub deposunu takip edin (Watch → Custom → Releases).

Kurulumdan sonra kontrol listesi

• Site https:// üzerinden açılıyor ve http:// buna yönlendiriliyor.
• Editörün üzerine bir Markdown dosyası sürükleyin — yeni bir sekmede açılıyor.
• Ayarlardan temayı ve dili değiştirin.
• İndirmelerin çalıştığını doğrulamak için bir test belgesini HTML olarak dışa aktarın.

Editörünüz yayına girdiğinde Markdown kopya kâğıdını ekibinizle paylaşın; Markdown önizleme ve HTML ile PDF’e dışa aktarma rehberlerimizi de yer imlerinize ekleyin.