Markdown yazmak için harikadır, ama belge gönderdiğiniz kişiler çoğu zaman bir web sayfası ya da PDF bekler. İyi haber: Markdown’ı dönüştürmek kolaydır ve çoğu durumda karmaşık bir araç zincirine ihtiyacınız yoktur.
Aşağıda en hızlıdan en yapılandırılabilire doğru dört yol ve çıktının profesyonel görünmesini sağlayan bir dizi ipucu bulacaksınız.
Hızlı karşılaştırma
| Yöntem | HTML | Kurulum | En uygun olduğu durum | |
|---|---|---|---|---|
| Tarayıcı editöründen dışa aktarma | ✅ | ✅ (yazdırma) | Hiçbir şey | Günlük belgeler, hızlı paylaşım |
| VS Code + eklenti | ✅ | ✅ | Editör + eklenti | Zaten VS Code’da yazanlar |
| Pandoc | ✅ | ✅ | Pandoc (+ bir PDF motoru) | Kitaplar, makaleler, otomatik iş akışları |
| Bir betik (markdown-it, marked) | ✅ | — | Node.js | Özel web siteleri ve derleme adımları |
1. Tarayıcı tabanlı bir editörden dışa aktarın
En hızlı yol, doğrudan dışa aktarabilen bir editördür. Markdown Preview Editor’da belgenizi açın ya da yapıştırın — çevrim içi sürümden veya kendi kopyanızdan — ve üst çubuktaki düğmeleri kullanın:
- HTML, tek ve bağımsız bir
.htmldosyası oluşturur. Stiller, kod renklendirme, formüller, diyagramlar ve belgeyle birlikte açtığınız görseller gömülür; böylece dosya her bilgisayarda doğru görünür, e-postaya eklenebilir ya da olduğu gibi herhangi bir yere yüklenebilir. - Yazdır, tarayıcının yazdırma penceresini açar. PDF elde etmek için hedef olarak PDF olarak kaydet seçeneğini seçin. Yalnızca işlenmiş belge yazdırılır — araç çubuğu da editör de yazdırılmaz.
- Kaydet, Markdown kaynağını
.mddosyası olarak indirir.
Her şey tarayıcıda gerçekleştiği için bu yöntem, çevrim içi bir dönüştürücüye yüklemek istemeyeceğiniz belgeler için de işe yarar.
Yazdırma penceresinden temiz bir PDF almak
- Sayfa başına ne kadar metin istediğinize göre Kenar boşlukları ayarını Varsayılan veya Minimum yapın.
- Sayfa kenarlarındaki tarih ve URL’yi kaldırmak için Üst bilgiler ve alt bilgiler seçeneğini kapatın.
- Kod bloğu arka planlarını ve tablo çizgilerini istiyorsanız Arka plan grafikleri seçeneğini açın.
- Yazdırmak için açık tema kullanın — mürekkepten tasarruf sağlar ve kâğıtta daha kolay okunur.
2. Eklentiyle VS Code
VS Code’un yerleşik bir Markdown önizlemesi vardır ama dışa aktarma düğmesi yoktur. Markdown PDF veya Markdown Preview Enhanced gibi eklentiler HTML ve PDF’e aktarma komutları ekler. VS Code zaten editörünüzse bu kullanışlıdır; çıktının görünümü eklentiye bağlıdır ve bazı eklentiler ilk kullanımda başsız (headless) bir tarayıcı indirir.
3. Pandoc — evrensel dönüştürücü
Pandoc onlarca biçim arasında dönüştürme yapar ve kitaplar, akademik makaleler ve otomatik belgeler için standart araçtır. Kurulumdan sonra dönüştürme tek bir komuttur:
bash# Markdown'dan eksiksiz bir HTML sayfasına
pandoc report.md -o report.html --standalone --metadata title="Report"
# Markdown'dan PDF'e (bir PDF motoru gerekir, ör. bir LaTeX dağıtımı)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Markdown'dan Word'e, biri ısrar ederse
pandoc report.md -o report.docx
--standalone olmadan Pandoc yalnızca bir HTML parçası üretir — bunu mevcut bir sayfaya eklemek istiyorsanız kullanışlıdır. PDF çıktısı ayrı bir motor gerektirir: bir LaTeX dağıtımı ya da WeasyPrint gibi HTML tabanlı bir motor. Pandoc’un gücü kontroldedir: şablonlar, kaynak gösterimleri, numaralı bölümler ve çapraz başvurular.
4. Birkaç satır JavaScript
Markdown kendi web sitenizin ya da derleme sürecinizin bir parçasıysa en esnek seçenek bir kütüphanedir. markdown-it ile:
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
Eklentiler dipnotlar, görev listeleri, matematik ve daha fazlasını ekler. Çıktının ancak girdisi kadar güvenli olduğunu unutmayın: Markdown başkalarından geliyorsa HTML’i yayımlamadan önce temizleyin (örneğin DOMPurify ile).
Daha iyi HTML ve PDF çıktısı için ipuçları
Tek ve net bir başlıkla başlayın
Dönüştürücüler belge başlığını dosya adından, ilk başlıktan ya da açıkça belirtilen meta verilerden alır. Her belgeye açıklayıcı bir dosya adı ve tek bir # başlığı verin; dışa aktarılan HTML ve PDF, indirilenler klasöründe ya da tarayıcı sekmesinde kolayca tanınır.
Görselleri belgenin yanında tutun
images/chart.png gibi göreli yollar kullanın ve dosyaları aynı klasörde tutun. Bütün klasörü Markdown Preview Editor’da açtığınızda görseller çözülür ve HTML çıktısına gömülür. Önizlemede yüklenmeyen uzak görseller de gömülmez.
Sayfa sonlarını kontrol edin
Markdown’ın sayfa sonu sözdizimi yoktur. Basılı belgelerde büyük bölümleri bir ## başlığıyla başlatın ve tabloları kısa tutun — tarayıcılar tablo satırlarını bölmekten kaçınır, ama çok büyük bir tablo yine de sonraki sayfada devam eder. Pandoc gibi ham HTML’e ve satır içi stillere izin veren araçlarda <div style="page-break-after: always"></div> ekleyebilirsiniz.
Dışa aktarmadan önce formülleri ve diyagramları kontrol edin
Çoğu araçta matematik ve diyagramlar JavaScript kütüphaneleriyle işlenir. Önce önizlemede kontrol edin — Markdown’da matematik denklemleri ve Mermaid diyagramları rehberlerimize göz atın. Markdown Preview Editor’ın HTML çıktısında bunlar hazır biçimlendirme ve görseller olarak saklanır; bu yüzden dışa aktarılan dosyanın hiçbir betiğe ihtiyacı olmaz.
Temayı bilinçli seçin
Koyu HTML çıktıları ekranda hoş görünür ama kâğıt için kötü bir tercihtir. Okuyucunun kullanacağı ortama göre dışa aktarın.
Sıkça sorulan sorular
Markdown ücretsiz olarak PDF’e nasıl dönüştürülür?
Belgeyi Markdown Preview Editor gibi bir Markdown önizleyicide açın, Yazdır’a tıklayın ve yazdırma penceresinde PDF olarak kaydet seçeneğini seçin. Otomatik veya kitap tarzı çıktı için ücretsiz Pandoc komut satırı aracını kullanın.
Hiçbir şey kurmadan Markdown HTML’e nasıl dönüştürülür?
HTML dışa aktarma özelliği olan tarayıcı tabanlı bir editör kullanın. Markdown Preview Editor, stillerin dahil olduğu bağımsız bir HTML dosyasını doğrudan tarayıcınızda oluşturur.
Görseller dışa aktarılan HTML’e dahil edilir mi?
Belgeyle birlikte açtığınız yerel görseller HTML dosyasına gömülür; böylece dosya tek başına çalışır. Uzak sunucularda kalan görseller gömülmez.
Markdown’ı Word’e (DOCX) dönüştürebilir miyim?
Evet, Pandoc ile: pandoc input.md -o output.docx. Alternatif olarak HTML’e aktarıp Word’de açabilirsiniz; biçimlendirmenin çoğu korunur.