Markdown Hile Sayfası
Son güncelleme
Başlıklar
# işaretlerinden sonra bir boşluk bırakın. İşaret sayısı 1'den 6'ya kadar başlık seviyesini belirler.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Başlık 1 | # Page title | Üst seviye başlık, <h1> |
| Başlık 2 | ## Section | Bölüm başlığı, <h2> |
| Başlık 3 | ### Subsection | Alt bölüm başlığı, <h3> |
| Başlık 4 ile 6 arası | #### Level 4
##### Level 5
###### Level 6 | <h4>, <h5> ve <h6> |
| Başlık 1, alternatif | Page title
========== | <h1>, # Page title ile aynı |
| Başlık 2, alternatif | Section
------- | <h2>, ## Section ile aynı |
| Kapanış diyezleri | ## Section ## | <h2>Section</h2>; sondaki # işaretleri yok sayılır |
| Eksik boşluk | #Not a heading | Düz bir paragraf. # işaretinden sonraki boşluk zorunludur |
Kalın, italik ve üstü çizili
Yıldız işaretleri her yerde, kelimenin içinde bile çalışır. Alt çizgiler yalnızca kelime sınırlarında çalışır, bu yüzden snake_case yazıldığı gibi kalır.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Kalın | **bold text** | Kalın, <strong>bold text</strong> |
| Kalın, alt çizgiyle | __bold text__ | Kalın, yukarıdakiyle aynı |
| İtalik | *italic text* | İtalik, <em>italic text</em> |
| İtalik, alt çizgiyle | _italic text_ | İtalik, yukarıdakiyle aynı |
| Kalın ve italik | ***bold and italic*** | <em><strong>bold and italic</strong></em> |
| Kelime içinde kalın | un**believ**able | Yalnızca kelimenin ortası kalın olur |
| Kelime içinde alt çizgi | snake_case_name | Düz metin, italik olmaz |
| Üstü çizili (GFM) | ~~no longer true~~ | Üstü çizili, <del>no longer true</del> |
| Altı çizili | <ins>underlined</ins> | Altı çizili metin. Markdown'da altı çizme sözdizimi yoktur, bu yüzden bu HTML'dir |
| Vurgulama | <mark>highlighted</mark> | Sitenin <mark> etiketine izin verdiği yerlerde vurgulanmış metin. Markdown'da vurgulama sözdizimi yoktur |
Satır sonları ve paragraflar
Bir paragrafın içinde Enter'a bir kez basmak çıktıda yeni bir satır başlatmaz. Bunun yerine şunlardan birini kullanın.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Yeni paragraf | First paragraph.
Second paragraph. | İki paragraf. Aralarını boş bir satır ayırır |
| Satır sonu: iki boşluk | Roses are red,
Violets are blue. | red, sonrasında bir <br> bulunan tek paragraf. İlk satır, göremediğiniz iki boşlukla biter |
| Satır sonu: ters eğik çizgi | Roses are red,\
Violets are blue. | Aynı <br>, bu kez görebildiğiniz bir işaretle. CommonMark'ta ve GitHub'da çalışır |
| Satır sonu: HTML | Roses are red,<br>Violets are blue. | Aynı <br>. Tablo hücresinin içinde de çalışır |
| Tek satır sonu | Roses are red,
Violets are blue. | Tek satır: Roses are red, Violets are blue. GitHub issue'ları ve yorumları satır sonunu korur; .md dosyaları korumaz |
| Fazladan boş satırlar | One.
Two. | Tek bir boş satırla aynı. Daha fazla boşluk için <br>'yi ayrı bir satıra yazın |
Listeler
İç içe bir öğeyi üstteki öğenin metniyle hizalanacak şekilde girintileyin: - altında 2 boşluk, 1. altında 3 boşluk.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Madde işaretli liste | - Apples
- Pears
- Plums | Madde işaretli liste, üç <li> içeren bir <ul> |
| Diğer madde işaretleri | * Apples
+ Pears | * ve + da madde işareti oluşturur. Karakteri değiştirmek yeni bir liste başlatır |
| Numaralı liste | 1. Install
2. Configure
3. Run | Numaralı liste, <ol> |
| Tembel numaralandırma | 1. Install
1. Configure
1. Run | Yine 1, 2, 3 diye numaralanır. Yalnızca ilk sayı dikkate alınır |
| Belirli bir sayıdan başlamak | 7. Seventh
8. Eighth | <ol start="7">, 7'den başlayarak numaralanır |
| İç içe liste | - Fruit
- Apple
- Pear
- Vegetables | İlk öğenin içinde bir liste |
| İç içe, numaralı | 1. Download
- Windows
- macOS
2. Install | 1. adımın içinde, 3 boşluk girintili madde işaretleri |
| Öğe içinde paragraf | - First item
More about the first item.
- Second item | İlk öğenin içinde iki paragraf |
| Öğe içinde kod | 1. Run this:
```bash
npm install
```
2. Start the app | 1. adımın içinde, öğenin metnine göre girintilenmiş bir kod bloğu |
Görev listeleri (onay kutuları)
Bir GitHub Flavored Markdown uzantısı: [ ] ya da [x] ile başlayan bir liste öğesi onay kutusuna dönüşür.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Boş onay kutusu | - [ ] Write tests | İşaretlenmemiş bir onay kutusu |
| İşaretli onay kutusu | - [x] Write tests | İşaretlenmiş bir onay kutusu. [X] de çalışır |
| Kontrol listesi | - [x] Draft
- [ ] Review
- [ ] Publish | Bir işaretli ve iki boş kutu. GitHub issue'larında ve pull request'lerde tek tıkla işaretleyebilirsiniz |
| İç içe görevler | - [ ] Release
- [x] Tag the commit
- [ ] Write the notes | İlk kutunun altında iki alt görev |
| Eksik boşluk | - [] Write tests | [] Write tests olarak okunan düz bir madde. Köşeli parantezlerin arasında bir boşluk ya da x olmalı |
Bağlantılar
Bağlantı metni köşeli parantezlere, adres de hemen ardından aralarında boşluk olmadan normal parantezlere yazılır.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Satır içi bağlantı | [Coddy](https://coddy.tech) | <a href="https://coddy.tech">Coddy</a> |
| Başlıklı bağlantı | [Coddy](https://coddy.tech "Learn to code") | Aynı bağlantı. Başlık, fareyle üzerine gelindiğinde ipucu olarak görünür |
| Açılı parantez içinde URL | <https://coddy.tech> | URL'nin kendisi, bağlantı olarak |
| Çıplak URL (GFM) | https://coddy.tech | GitHub'da ve www. adreslerini de bağlantıya çeviren diğer GFM sitelerinde bir bağlantı. Katı CommonMark'ta düz metin |
| E-posta bağlantısı | <hello@example.com> | Bir mailto: bağlantısı |
| Referans bağlantısı | Read the [docs][1].
[1]: https://example.com/docs | docs URL'ye bağlanır. [1]: satırı gösterilmez |
| Kısa referans | See [GitHub].
[GitHub]: https://github.com | GitHub URL'ye bağlanır |
| Göreli bağlantı | [Install guide](docs/install.md) | Bu dosyaya göre konumlanan bir dosyaya bağlantı. GitHub'da dosyayı depo içinde açar |
| Başlığa bağlantı | [Jump to setup](#getting-started) | Aynı sayfadaki ## Getting Started başlığına kaydırır |
| Başlık kimlikleri | ## Getting Started! | GitHub'da getting-started kimliğini alır: küçük harfe çevrilir, boşluklar kısa çizgi olur, - ve _ dışındaki noktalama işaretleri atılır |
| Başka bir dosyadaki başlık | [Requirements](docs/install.md#requirements) | Dosyayı o başlıkta açar |
| URL'de boşluk | [Report](my%20report.pdf) | Her boşluğu %20 olarak yazın ya da URL'yi açılı parantez içine alın: [Report](<my report.pdf>) |
| Yeni sekmede açmak | <a href="https://coddy.tech" target="_blank">Coddy</a> | Markdown'da bunun için bir sözdizimi yoktur. HTML, sitenin target özniteliğini koruduğu yerlerde çalışır |
Görseller
Görsel, önünde ! bulunan bir bağlantıdır. Köşeli parantez içindeki metin, ekran okuyucuların sesli okuduğu alternatif metin (alt) olur.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Görsel |  | <img src="cat.png" alt="A cat asleep on a sofa"> |
| Başlıklı görsel |  | Fareyle üzerine gelindiğinde ipucu gösteren aynı görsel |
| URL'den görsel |  | Görseli web'den yükler |
| Bağlantılı görsel | [](https://coddy.tech) | Tıklandığında bağlantıyı açan bir görsel |
| Referans görseli | ![Logo][logo]
[logo]: images/logo.png | Satır içi görselle aynı, URL aşağıda bir kez tanımlanır |
| Görsel boyutu | <img src="logo.png" alt="Logo" width="200"> | 200 piksel genişliğinde görsel. Düz Markdown'da boyut sözdizimi yoktur, bu yüzden bu bir HTML <img> etiketidir |
| Ortalanmış görsel | <p align="center">
<img src="logo.png" alt="Logo" width="200">
</p> | Birçok GitHub README dosyasında görüldüğü gibi ortalanmış bir görsel |
Kod ve kod blokları
Ters tırnaklar satır içindeki kodu işaretler; üç ters tırnaktan oluşan bir çit ise bir bloğu işaretler. Kodun içindeki hiçbir şey biçimlendirilmez.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Satır içi kod | Run `npm install` first. | npm install eş aralıklı yazı tipiyle, <code> olarak |
| Kod içinde ters tırnak | ``Use `git` here`` | Use `git` here kodu. İçerdiğinden daha fazla ters tırnakla sarın |
| Kod bloğu | ```
npm install
npm run dev
``` | Satır sonları korunmuş bir blok, <pre><code> |
| Sözdizimi vurgulama | ```python
def greet(name):
return f"Hello, {name}"
``` | Renkli sözdizimine sahip bir Python bloğu. Yaygın adlar: js, ts, python, bash, json, html, css, sql |
| Tilde çiti | ~~~js
console.log("hi");
~~~ | Ters tırnak çitiyle aynı |
| Girintili kod | const total = 42; | Boş bir satırdan sonra 4 boşluk girintiyle oluşturulan kod bloğu |
| Diff bloğu | ```diff
- const x = 1;
+ const x = 2;
``` | GitHub'da silinen satırlar kırmızı, eklenen satırlar yeşil gösterilir |
| Blok içinde çit | ````markdown
```js
let a = 1;
```
```` | İçteki çiti metin olarak gösteren bir blok. Dıştaki çitin içtekinden daha fazla ters tırnağı olmalı |
Tablolar
Bir GitHub Flavored Markdown uzantısı. İkinci satır, yani ayırıcı satır, ilk satırı başlık satırına dönüştürür. Başlıkla aynı sayıda hücresi olmalıdır, aksi halde tablo oluşmaz.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Tablo | | Name | Role |
| ----- | ------ |
| Ada | Admin |
| Linus | Editor | | Bir başlık satırı ve iki satırdan oluşan tablo |
| Sütun hizalama | | Left | Center | Right |
| :--- | :----: | ----: |
| a | b | c | | İki nokta işaretleri hizalamayı belirler: sola, ortaya, sağa |
| Dış dikey çizgiler olmadan | Name | Role
--- | ---
Ada | Admin | Aynı tablo. Satırın başındaki ve sonundaki dikey çizgiler isteğe bağlıdır |
| Sütun genişliği | | a | b |
|---|---|
| 1 | 2 | | Genişlikler içerikten gelir. Kısa çizgilerin sayısı önemli değildir ve dikey çizgilerin hizalı olması gerekmez |
| Hücrelerde biçimlendirme | | Command | Does |
| --- | --- |
| `git status` | Shows **changed** files | | Kod, kalın, bağlantılar ve görseller hücrelerin içinde çalışır |
| Hücre içinde dikey çizgi | | Operator | Meaning |
| --- | --- |
| `a \| b` | a or b | | Hücre a | b gösterir. Dikey çizgiyi kodun içinde bile \| olarak kaçırın |
| Hücre içinde satır sonu | | Step | Notes |
| --- | --- |
| 1 | First line<br>Second line | | Tek hücrede iki satır. Gerçek bir satır sonu satırı bitirirdi |
| Birleştirilmiş hücreler | <td colspan="2">Both columns</td> | Markdown tabloları hücre birleştiremez. Tabloyu colspan ya da rowspan ile HTML olarak yazın |
Alıntı blokları
Her satıra > ile başlayın. Bir alıntı bloğu başka her türlü Markdown'ı içerebilir.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Alıntı bloğu | > Simple is better than complex. | Girintili bir alıntı, <blockquote> |
| Birden fazla paragraf | > First paragraph.
>
> Second paragraph. | İki paragraflı tek bir alıntı. Yalnızca > içeren satır onları bir arada tutar |
| İç içe alıntı | > The reply
>> The original message | Alıntı içinde alıntı |
| İçinde başka öğeler | > #### Note
> - Back up first
> - Then upgrade | Alıntının içinde bir başlık ve bir liste |
| Uyarı kutusu (GitHub) | > [!NOTE]
> Requires Node 20 or later. | GitHub'da renkli bir Note kutusu. Diğer türler [!TIP], [!IMPORTANT], [!WARNING] ve [!CAUTION] |
Yatay çizgiler
Bir satırda tek başına duran üç ya da daha fazla kısa çizgi, yıldız ya da alt çizgi sayfa boyunca bir çizgi çeker.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Çizgi | --- | Yatay bir çizgi, <hr> |
| Diğer biçimler | ***
___ | İki çizgi daha |
| Metinden sonra çizgi | Some text
--- | Bir paragraf, ardından bir çizgi. Boş satırı koruyun |
| Eksik boş satır | Some text
--- | Çizgi değil, 2. seviye bir başlık: bir metin satırının altındaki --- o satırın altını çizer |
Dipnotlar
GitHub'da, GitLab'de ve birçok statik site oluşturucuda desteklenir. Katı CommonMark'ta dipnot yoktur.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Dipnot | Markdown dates from 2004.[^1]
[^1]: John Gruber created it, with Aaron Swartz. | Nota bağlanan bir üst simge 1; not sayfanın en altında listelenir |
| Adlandırılmış dipnot | See the spec.[^spec]
[^spec]: https://spec.commonmark.org | Etiketler kelime olabilir, ama notlar yine kullanım sırasına göre 1, 2, 3 diye numaralanır |
| Nerede tanımlanır | [^1]: The text of the note. | Tanım dosyanın herhangi bir yerinde olabilir. Her zaman sonda gösterilir |
Karakterleri kaçırma (escaping)
Bir noktalama işaretinden önce gelen ters eğik çizgi, biçimlendirme yerine karakterin kendisini yazdırır.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Düz yıldız işaretleri | \*not italic\* | Yıldız işaretleriyle birlikte düz metin: *not italic* |
| Düz diyez | \# Not a heading | # ile başlayan bir paragraf |
| Sayı ve nokta | 2024\. A good year. | 2024'ten başlayan bir liste değil, bir paragraf |
| Düz köşeli parantezler | \[not a link\](page.md) | Köşeli ve normal parantezler yazıldığı gibi |
| Düz ters tırnak | \` | Bir ters tırnak |
| Düz ters eğik çizgi | \\ | Bir ters eğik çizgi |
| Neler kaçırılabilir | \ ` * _ {} [] () <> # + - . ! | | Tüm ASCII noktalama işaretleri. Bir harf ya da rakamdan önceki ters eğik çizgi ters eğik çizgi olarak kalır |
| HTML varlıkları | © 2026 & <div> | © 2026 & <div>, metin olarak |
| Kodda kaçırma yok | `*stars*` | *stars* kodu yazıldığı gibi. Kodun içinde ters eğik çizgi sıradan bir karakterdir |
Markdown içinde HTML
Çoğu işleyici HTML'yi olduğu gibi geçirir, bu yüzden Markdown'da sözdizimi olmayan şeyler için bir etiket kullanılabilir. GitHub <script>, <style>, <iframe> ve style öznitelikleri gibi güvensiz HTML'yi kaldırır.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Klavye tuşları | Press <kbd>Ctrl</kbd> + <kbd>C</kbd> | Ctrl ve C tuş olarak çizilir |
| Alt ve üst simge | H<sub>2</sub>O and x<sup>2</sup> | H₂O ve x² |
| Açılır kapanır bölüm | <details>
<summary>Show the answer</summary>
The answer is **42**.
</details> | Tıklayınca açılan bir bölüm. Boş satırlar içindeki Markdown'ın işlenmesini sağlar |
| HTML bloğunda Markdown | <div>
**not bold**
</div> | **not bold** yazıldığı gibi. Bir HTML bloğunun içindeki Markdown, blok boş bir satırla bitene kadar okunmaz |
| Renkli metin | <span style="color: red">red</span> | Satır içi stillere izin veren sitelerde kırmızı metin. GitHub style özniteliğini kaldırır |
Yorumlar
Markdown'da yorum sözdizimi yoktur. İki yöntem metni işlenmiş sayfanın dışında tutar.
| Öğe | Markdown | Sonuç |
|---|---|---|
| Gizli yorum | [//]: # (This line is never shown) | Hiçbir şey. Satır, hiçbir bağlantının kullanmadığı bir bağlantı tanımıdır, bu yüzden HTML'ye hiç ulaşmaz |
| Alternatif biçim | [comment]: <> (Also hidden) | Hiçbir şey, aynı yöntemle |
| HTML yorumu | <!-- TODO: add screenshots --> | Sayfada hiçbir şey görünmez, ama yorum HTML kaynağında kalır |
| Çok satırlı yorum | <!--
This whole block
is hidden
--> | Sayfada hiçbir şey görünmez |
| Konum | Some text.
[//]: # (comment)
More text. | İki paragraf. Yorum satırından önce boş bir satır olmalıdır, aksi halde metin olarak görünür |
GitHub Flavored Markdown ve GitHub'a özgü eklemeler
GitHub Flavored Markdown (GFM), CommonMark'a tablolar, görev listeleri, üstü çizili metin ve çıplak URL bağlantıları ekler. GitHub bunların üstüne daha fazlasını ekler.
| Özellik | Markdown | Nerede çalışır |
|---|---|---|
| Tablolar | | a | b |
| --- | --- |
| 1 | 2 | | GFM: GitHub, GitLab ve çoğu dokümantasyon aracı |
| Görev listeleri | - [x] Done | GFM |
| Üstü çizili | ~~text~~ | GFM |
| Çıplak URL bağlantıları | www.coddy.tech | GFM |
| Dil belirtilmiş kod | ```js
let a = 1;
``` | CommonMark ve GFM. Renkler siteden gelir |
| Dipnotlar | Text.[^1]
[^1]: Note. | GitHub ve GitLab, GFM spesifikasyonunda olmasalar da |
| Emoji | :rocket: :tada: | GitHub ve GitLab kısa kodları emojiye çevirir |
| Bahsetmeler | @octocat | GitHub: kullanıcıya bağlantı verir ve ona bildirim gönderir |
| Issue bağlantıları | #123 | GitHub: aynı depodaki 123 numaralı issue ya da pull request'e bağlanır |
| Diyagramlar | ```mermaid
graph LR
A --> B
``` | GitHub ve GitLab bir Mermaid diyagramı çizer |
| Matematik | $E = mc^2$
$$
\sum_{i=1}^{n} i
$$ | GitHub LaTeX matematiğini işler: $ işaretleri arasında satır içi, $$ satırları arasında blok olarak |
Markdown sözdiziminin tamamı tek sayfada, her birinin neye dönüştüğüyle yan yana. Bu Markdown hile sayfası temel sözdizimini (başlıklar, vurgu, satır sonları, listeler, bağlantılar, görseller, kod, alıntı blokları) ve GitHub Flavored Markdown eklemelerini kapsar: hizalamalı tablolar, görev listeleri, üstü çizili metin, çıplak URL bağlantıları ve dipnotlar; ayrıca karakter kaçırma, HTML ve yorumlar.
Örnekler, GitHub'ın, GitLab'in ve çoğu dokümantasyon aracının temel aldığı CommonMark ve GitHub Flavored Markdown kurallarını izler. Bir sitenin farklı davrandığı yerlerde satır bunu belirtir. Herhangi bir örneğin siz yazarken nasıl işlendiğini görmek için onu Markdown editörüne yapıştırın.
Markdown hile sayfası SSS
Markdown'da tablo nasıl yapılır?
| Name | Role |, | --- | --- |, | Ada | Admin |. Ayırıcı satırdaki iki nokta işaretleri bir sütunu hizalar: :--- sola, :---: ortaya, ---: sağa. Tablolar bir GitHub Flavored Markdown özelliğidir; GitHub'da, GitLab'de ve çoğu dokümantasyon aracında çalışır, ama katı CommonMark'ta çalışmaz.Markdown'da alt satıra nasıl geçilir?
\) bitirin veya <br> yazın. Yeni bir paragraf başlatmak için boş bir satır bırakın. İstisna GitHub issue'ları ve yorumlarıdır: orada tek bir satır sonu zaten satır sonu olarak görünür.Markdown'da yorum nasıl yazılır?
[//]: # (your comment), hiçbir şeyin kullanmadığı bir bağlantı tanımıdır; bu yüzden ne sayfaya ne de HTML'ye ulaşır. Bir HTML yorumu, <!-- your comment -->, sayfada da gizlidir ama HTML kaynağında kalır ve kaynağı görüntüleyen herkes onu okuyabilir.Markdown'da kod bloğu nasıl yapılır?
```python gibi bir dil adı ekleyin. Cümle içindeki kod için onu tek ters tırnaklarla sarın: `npm install`.Markdown'da onay kutusu nasıl eklenir?
[ ], işaretli bir kutu için [x] ile başlatın: - [ ] Review ya da - [x] Draft. Boş köşeli parantezlerin içindeki boşluğu koruyun. Onay kutuları GitHub Flavored Markdown'ın bir parçasıdır ve GitHub issue'larında ve pull request'lerde onları tek tıkla işaretleyebilirsiniz.Markdown'da bir görselin boyutu nasıl değiştirilir?
 görseli her zaman kendi boyutunda gösterir. Bunun yerine GitHub'ın ve çoğu işleyicinin kabul ettiği <img src="image.png" alt="alt text" width="300"> gibi bir HTML etiketi kullanın. Oranları korumak için yalnızca genişliği ya da yalnızca yüksekliği ayarlayın.Markdown'da bir başlığa nasıl bağlantı verilir?
# ile bağlantı verin: [Setup](#getting-started), ## Getting Started başlığına atlar. GitHub kimliği başlık metninden oluşturur: küçük harfe çevirir, boşlukları kısa çizgiye dönüştürür ve kısa çizgi ile alt çizgi dışındaki noktalama işaretlerini kaldırır. Başka bir dosyadaki başlık için kimliği dosya adından sonra yazın: [Setup](docs/install.md#getting-started)..md dosyası nedir?
.md ve .markdown'dır; README.md de GitHub'ın bir deponun ana sayfasında gösterdiği dosyadır. Herhangi bir metin düzenleyici onu açar; GitHub, dokümantasyon siteleri ve Markdown görüntüleyiciler onu biçimlendirilmiş metin olarak gösterir. Bir dosyanın düzenlerken nasıl işlendiğini görmek için onu Markdown editörüne yapıştırın.