Markdown Kopya Kâğıdı

Adım 1 / 3 33%

Bir Markdown konusu seçin

Bir örnek grubuyla başlayın, ardından tam başvuru kaynağını açın.

Temel Markdown sözdizimi kategorilere ayrılır ve kopyalanabilir kaynakla gerçek bir ayrıştırıcının çıktısını yan yana gösterir. CommonMark temellerini (başlıklar, listeler, vurgu, bağlantılar, görseller ve çitli kod blokları) ve GitHub Flavored Markdown uzantılarını (tablolar, görev listeleri, üstü çizili metin ve düz URL’leri otomatik bağlama) kapsar. GitHub, GitLab, Obsidian ve statik site oluşturucularla çalışırken elinizin altında bulundurun.

Kopya kâğıdı nasıl kullanılır?

  1. 1

    Kategoriye göre göz atın

    Başlıklara, listelere, koda, bağlantılara, tablolara veya GFM uzantılarına atlayın.

  2. 2

    Kaynağı ve sonucu karşılaştırın

    Her örnek ham Markdown metnini gerçek bir GFM ayrıştırıcısının çıktısıyla yan yana gösterir.

  3. 3

    Parçacığı kopyalayın

    Herhangi bir örneğin kaynağını almak için kopyala düğmesine dokunun.

  4. 4

    Sözdizimi etiketini kontrol edin

    Her örnek CommonMark veya GitHub Flavored Markdown (GFM) olarak etiketlenir.

Başlıklar

# H1 başlığı
## H2 bölümü
### H3 alt bölümü

Setext (metnin altında ===) yerine ATX biçimini (#) kullanın. Tüm ayrıştırıcılar her ikisini de destekler, ancak ATX bir diff içinde daha kolay okunur.

Vurgu

*italik* veya _italik_, **kalın** veya __kalın__, ***kalın italik***. GFM, ~~üstü çizili~~ biçimini ekler.

Listeler

Sırasız listeler -, * veya + kullanır (birini seçin ve ona bağlı kalın):

- Birinci
- İkinci
  - İç içe (iki boşluk)

Sıralı listeler otomatik olarak yeniden numaralandırılır:

1. Öğe
1. Öğe
1. Öğe

Kod

Satır içi: `code`. İsteğe bağlı dil etiketli çitli bloklar:

```python
def hello(name):
    return f"Merhaba, {name}"
```

Eski söz dizimini tercih ediyorsanız, kod bloğunu dört boşlukla girintileyin.

Bağlantılar ve resimler

[Bağlantı metni](https://example.com)
[Başlıklı bağlantı](https://example.com "İpucu")
![Alternatif metin](/path/to/image.png)

Referans biçimi, uzun URL’leri paragrafın dışında tutar:

[Belgelere][1] bakın.

[1]: https://example.com/docs

Tablolar (GFM)

| Col A | Col B |
|-------|------:|
| a     |     1 |
| b     |    22 |

Hizalama, ayırıcı satırda iki nokta üst üste kullanır: :--- sola, :---: ortaya, ---: sağa.

Görev listeleri (GFM)

- [x] Bitti
- [ ] Yapılacak

Yaygın tuzaklar

  • Satır sonundaki iki boşluk, bir paragraf içinde satır sonu ekler. Tek boşluk yalnızca satırları birleştirir.
  • Çoğu blok öğesinden (başlıklar, listeler, kod blokları) önce boş satır gereklidir.
  • İşleyiciniz boşluk bekliyorsa liste imlerini sekme ile girintilemeyin; iki veya dört boşlukla girintileyin.
  • Noktalama işaretlerini olduğu gibi göstermek için ters eğik çizgiyle kaçış yapın: \*italik değil\*.
  • Akıllı tırnak işaretleri işleyiciye göre farklılık gösterir. GitHub onları olduğu gibi bırakır; Pandoc ise dönüştürür.

Sık Sorulan Sorular

CommonMark; başlıklar, listeler, bağlantılar ve isteğe bağlı bilgi dizesi içeren çitli kod blokları gibi taşınabilir çekirdeği tanımlar. GFM tabloları, görev listelerini, üstü çizili metni ve düz URL’lerin otomatik bağlanmasını ekler. Diğer düzenleyiciler bir alt kümeyi destekleyebilir veya kendi uzantılarını ekleyebilir.

Markdown, tek bir satır sonunu boşluk olarak ele alır. Bir <br> için satırı iki boşlukla bitirin veya GFM’de satırın sonunda \ kullanın.

Evet, çoğu ayrıştırıcıda blok düzeyindeki HTML etiketleri olduğu gibi geçirilir. Bazı işleyiciler bunları temizler (GitHub, satır içi betikleri ve olay özniteliklerini kaldırır).

CommonMark yerleşik bir içindekiler sözdizimi sunmaz. GitHub başlık çapaları oluşturur ve birden çok başlık içeren dosyalarda taslak gösterir. Diğer platformların kendi kuralları vardır: MkDocs ilgili uzantı etkinken [TOC] kullanabilir, Docusaurus ise sayfa içindekilerini başlıklardan oluşturur.

CommonMark ve GFM kuralları işe yarar. Ancak Obsidian, yalnızca Obsidian’a özgü wiki bağlantıları ([[Sayfa adı]]), bilgi kutuları (callout) ve gömülü bloklar ekler; bu öğeler bu kopya kâğıdında yer almaz.

İlgili Araçlar