Menu

Markdown Editörü

Markdown'u canlı bölünmüş önizlemeyle yaz.

Son güncelleme

Görünüm
MarkdownBaşlamak için Markdown yazın
Önizleme
Oluşturulan Markdown burada görünür — tablolar, görev listeleri, kod ve daha fazlası.

Markdown editör nedir?

Markdown editör, yan yana çalışan bir yazma ortamıdır: bir tarafa düz metin Markdown yazarsınız, diğer tarafta render edilmiş önizleme anlık olarak güncellenir. GitHub'daki README dosyalarını, dokümantasyon portallarını, statik site üreticilerini, blog platformlarını, Obsidian gibi not uygulamalarını ve Discord ile Slack gibi sohbet araçlarını besleyen format budur.

Markdown'un asıl amacı, düz metin halinde okunabilir görünmek ve render edildiğinde yapılandırılmış HTML'e dönüşmektir. Biçimlendirme araç çubuklarıyla uğraşmak yerine yazmaya odaklanırsınız — teknik yazarların ve geliştiricilerin Markdown'u tercih etmesinin nedeni de tam olarak bu.

Modern Markdown editörlerin çoğu *GitHub-Flavored Markdown* (GFM) destekler. GFM; orijinal CommonMark spesifikasyonunun üzerine tablolar, görev listeleri, dil ipuçlu kod blokları, otomatik bağlantılar ve üstü çizili metin gibi özellikler ekler.

Markdown editör kullanırken neler öğreneceksiniz

  • Markdown düz metindir — hem editörünüzde okunabilir hem de HTML olarak render edilebilir, üstelik ne araç çubuğu ne de gizli biçimlendirme gerekir.
  • Başlıklar, listeler, bağlantılar ve vurgular tipik yazımın %90'ını karşılar. Tablolar ve kod blokları da geri kalan %10'un büyük kısmını halleder.
  • Dil ipucu içeren kod blokları ( js , python ) birçok render motorunda söz dizimi vurgulamayı tetikler.

Adım adım Markdown editör kullanımı

  1. Sol panele yazmaya başlayın

    Başlıklar için #, vurgu için * veya _, listeler için - kullanın. Sağ panel siz yazdıkça güncellenir.

  2. Yapı ekleyin

    Belgeyi düzenlemek için başlıklar, kod blokları ve tablolar ekleyin. Editörlerin çoğunda yaygın biçimlendirme için klavye kısayolları (Ctrl+B, Ctrl+I) bulunur.

  3. Render edilen HTML'i önizleyin

    Canlı önizlemeyi kaynak ile karşılaştırın. Bir şey beklediğiniz gibi render edilmiyorsa, sebep genellikle eksik bir boş satır ya da hatalı kapatılmış bir kod bloğudur.

  4. Kopyalayın veya indirin

    Markdown kaynağını README'nize kopyalayın ya da HTML'i Markdown anlamayan bir e-posta, CMS veya başka bir yere yapıştırın.

Markdown söz dizimi kopya kâğıdı

Her gün kullanacağınız Markdown'un %80'i. Geri kalanı zaten bir Google aramasıyla öğrenilir. Spesifikasyonlar: CommonMark ve GitHub-Flavored Markdown.

ÖğeMarkdownŞöyle render edilir
Başlık 1# BaşlıkEn üst seviye başlık
Başlık 2## BölümBölüm başlığı
Kalın**strong****strong**
İtalik*emphasis* veya _emphasis_*emphasis*
Satır içi kod code code
Kod bloğuKodu üçlü ters tırnaklı blok içine alın, isteğe bağlı olarak dil ipucu ekleyinSöz dizimi vurgulanmış blok
Bağlantı`label`Tıklanabilir bağlantı
Görsel`!alt`Gömülü görsel
Liste- öğeMadde işaretli liste
Numaralı liste1. öğeSıralı liste
Görev listesi (GFM)- [x] tamamİşaretli onay kutusu
Tablo (GFM)| a | b |\n|---|---|\n| 1 | 2 |İki sütunlu tablo
Alıntı> alıntıGirintili alıntı

Deneyebileceğiniz Markdown örnekleri

Tipik bir README açılışı

Kaynak
# Project Name
A short description in one or two sentences.
## Install
```bashnpm install project-name```
## Quick start
- Step 1- Step 2- Step 3

Başlık, paragraf, kod bloğu içinde kurulum komutu ve bir madde listesi — her iyi README'nin omurgası budur.

Tablolar (GitHub-flavored)

Kaynak
| Feature | Free | Pro ||---------|:----:|:---:|| Editor  |||| Export  |      ||

Sütunları dikey çizgi (|) ayırır. Tireli satır sütunları hizalar, : karakterleri ise hizalamayı belirler (sol, orta, sağ). GFM tabloları için sütun genişliklerinin tam olması şart değildir — yalnızca yapı önemlidir.

Görev listesi

Kaynak
- [x] Draft the post- [x] Add screenshots- [ ] Publish

GitHub bunları issue ve PR'lar içinde etkileşimli onay kutuları olarak render eder. Belge içi kontrol listeleri ve hafif proje takibi için oldukça kullanışlıdır.

Yaygın Markdown hataları

  • Listelerin, tabloların ve kod bloklarının etrafına boş satır koymayı unutmak. Render motorlarının çoğu, yeni bir blok başlatmak için boş satır bekler.
  • Liste içinde tab ve boşluk karakterlerini karıştırmak — bazı render motorları girintiyi sessizce bozar.
  • Kod bloğunun içine ham HTML koyup render edilmesini beklemek. Kod blokları *birebir* gösterilir — zaten amaç da budur.

Markdown Editör SSS

Markdown nedir?
Markdown, basit düz metin söz dizimini (# başlık, **kalın**, `bağlantı`) biçimlendirilmiş HTML'e dönüştüren hafif bir işaretleme dilidir. Kaynak hâliyle bile okunabilir görünmek üzere tasarlanmıştır.
Markdown'u HTML'e nasıl dönüştürürüm?
Markdown'unuzu bir Markdown editöre yapıştırıp render edilen HTML'i kopyalayabilir ya da marked, markdown-it veya pandoc gibi bir dönüştürücü çalıştırabilirsiniz. Statik site üreticilerinin çoğu bu işi build sırasında otomatik yapar.
Markdown ile GitHub-Flavored Markdown arasındaki fark nedir?
GitHub-Flavored Markdown (GFM); standart Markdown'a tablolar, dil ipuçlu kod blokları, görev listeleri, otomatik bağlantılar ve üstü çizili metin ekler. GitHub, GitLab ve birçok dokümantasyon platformunun kullandığı lehçedir.
Markdown içinde HTML kullanabilir miyim?
Evet — render motorlarının çoğu ham HTML'i olduğu gibi geçirir. Markdown'un yerel olarak desteklemediği şeyleri (özel düzenler, video etiketleri) gömmek için işe yarar; ama bu, belgenizi HTML çıktısına bağımlı hâle getirir.
Markdown editör gizli mi?
Evet. Coddy'nin editörü Markdown'u tamamen tarayıcınızda render eder — metniniz hiçbir yere yüklenmez.

Diğer geliştirici araçları

Coddy ile kodlamayı öğren

BAŞLA