Markdown Sözdizimi Kılavuzu — Başlıklar, Tablolar, Kod ve Daha Fazlası

Bu, yer imi ekleyip geri dönebileceğiniz Markdown sözdizimi referansıdır. Her öğe gerçek bir örnekle ele alınmıştır — başlıklar, vurgu, bağlantılar, görseller, listeler, kod blokları, tablolar, alıntılar ve daha fazlası. Bir özellik standart CommonMark'ın parçasıysa böyle işaretlenmiştir; GitHub Flavored Markdown (GFM)'den gelen uzantılar açıkça belirtilmiştir, böylece neyin evrensel olarak desteklendiğini ve neyin renderer'a bağlı olduğunu bilirsiniz.

Başlıklar

Markdown'ın iki başlık stili vardır. ATX stili diyez karakterleri kullanır — h1 için bir #'dan h6 için altı ######'e kadar. Setext stili = veya - karakterlerin altını çizer ve yalnızca h1 ve h2'ye ulaşır. ATX her yerde kullanmanız gereken stildir — açık, altı seviyeye ölçeklenir ve her araç tarafından desteklenir. Yaygın bir hata: #'den sonra boşluk unutmak. Teknik olarak, #Başlık CommonMark'ta bir başlık değildir — boşluk zorunludur.

# Page Title (h1)
## Section Heading (h2)
### Subsection (h3)
#### Detail Level (h4)
##### Minor Heading (h5)
###### Smallest Heading (h6)

---

<!-- Setext style — only h1 and h2, rarely used -->
Page Title
==========

Section Heading
---------------

Gerçek bir belgede genellikle üstte bir h1 (belge başlığı), ana bölümler için h2 ve bunların içindeki alt bölümler için h3 kullanırsınız. h3'ün ötesine geçmek, belgenizin başka bir iç içe geçme seviyesi yerine yeniden yapılandırmaya ihtiyaç duyabileceğinin bir işaretidir.

Metin Biçimlendirme

Kalın, çift yıldız veya çift alt çizgi kullanır. İtalik, tek yıldız veya tek alt çizgi kullanır. Kalın-italik her ikisinden üçünü birleştirir. Üstü çizili, GFM uzantısıdır ve çift tilde kullanır. Satır içi kod backtick kullanır.

**Bold text** or __Bold text__
*Italic text* or _Italic text_
***Bold and italic*** or ___Bold and italic___
~~Strikethrough~~ (GFM only)
`inline code`

* ve _ varyantları çoğunlukla birbirleriyle değiştirilebilir, ancak bir uç durumda farklıdırlar: kelime ortası vurgusu. Yıldızlar kelime ortasında çalışır (ina*nan*ılmaz inananılmaz olarak render edilir), ancak alt çizgiler çalışmaz — ina_nan_ılmaz, CommonMark'ta kelimeler içindeki alt çizgiler vurgu işaretçisi değil kelime karakteri olarak ele alındığından literal olarak render edilir. Bu, tanımlayıcılarda alt çizgilerin göründüğü teknik yazmada önemlidir. Kural olarak: vurgu için * kullanın ve _'yi yalnızca güçlü bir stil tercihiniz varsa saklayın. Aynı vurgu kapsamında * ve _'yi karıştırmayın — *metin_ düzgün kapanmayacaktır.

Bağlantılar ve Görseller

Üç bağlantı stili vardır: satır içi bağlantılar, referans bağlantıları ve otomatik bağlantılar. Görseller, satır içi bağlantılarla aynı sözdizimini takip eder, ancak ! öneki ile.

<!-- Inline link: [text](url) or [text](url "title") -->
Read the [CommonMark spec](https://spec.commonmark.org/current/ "CommonMark Specification")
Format Markdown with the [Markdown Formatter](/markdown-formatter)

<!-- Reference link: define the URL separately — cleaner in long documents -->
Check the [GFM spec][gfm] for GitHub-specific extensions.

[gfm]: https://github.github.com/gfm/

<!-- Autolink: angle brackets make a URL or email clickable -->
<https://commonmark.org>
<[email protected]>

<!-- Image: same as inline link but with ! prefix -->
![Project screenshot](./docs/screenshot.png "Dashboard view")
![Alt text for accessibility](https://example.com/logo.png)

Listeler

Sırasız listeler madde işareti olarak -, * veya + kullanır. Sıralı listeler nokta ile takip eden sayılar kullanır. İki veya dört boşluk girintileyerek listeleri iç içe geçirin. Görev listeleri (GFM), işaretlenmemiş öğeler için [ ] ve işaretlenmiş öğeler için [x] kullanır.

<!-- Unordered list -->
- Install dependencies
- Configure environment variables
- Run the dev server

<!-- Ordered list -->
1. Clone the repository
2. Run `npm install`
3. Copy `.env.example` to `.env` and fill in values
4. Run `npm run dev`

<!-- Nested list (indent 2 or 4 spaces) -->
- Backend
  - Set up PostgreSQL
  - Configure connection string
- Frontend
  - Install Tailwind
  - Configure PostCSS

<!-- Task list (GFM) — great for README checklists -->
## Release Checklist

- [x] Unit tests passing
- [x] End-to-end tests passing
- [ ] Changelog updated
- [ ] Docker image tagged
- [ ] Deployment approved

Kod — Satır İçi ve Çevrilmiş

Satır içi kod, her iki tarafta tek bir backtick kullanır. Bloklar için, üçlü backtick (çevrilmiş kod blokları) kullanın ve isteğe bağlı olarak açılış çitinin hemen ardından dil tanımlayıcısını belirtin — bu, GitHub'da, VS Code önizlemelerinde ve çoğu statik site oluşturucuda sözdizimi vurgulamasını etkinleştirir. Girinti yaptırılmış kod blokları da kullanabilirsiniz (4 boşluk girintisi), ancak çevrilmiş bloklara tercih edin: dil ipuçlarını destekler, açıktır ve çevreleyen içerik de girintiye sahip olsa bile çalışır.

<!-- Inline code -->
Use the `fetch()` API to make HTTP requests.
Set the `Content-Type` header to `application/json`.

<!-- Fenced code block with language hint -->
```python
import json

with open("config.json") as f:
    config = json.load(f)

print(config["database"]["host"])
```

```typescript
interface ApiResponse<T> {
  data: T;
  status: number;
  message: string;
}

async function fetchUser(id: string): Promise<ApiResponse<User>> {
  const res = await fetch(`/api/users/${id}`);
  return res.json();
}
```

```bash
# Install dependencies and start the dev server
npm install
npm run dev
```

```json
{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "dev": "vite",
    "build": "tsc && vite build"
  }
}
```

```yaml
name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test
```

Yaygın dil tanımlayıcıları: python, js veya javascript, ts veya typescript, bash veya sh, json, yaml, html, css, sql, go, rust, java. Markdown Önizleme aracını kullanarak Markdown'ınızın nasıl render edildiğini önizleyin.

Tablolar (GFM)

Tablolar bir GitHub Flavored Markdown uzantısıdır — CommonMark standardının parçası değildir. GitHub, GitLab, çoğu statik site oluşturucu ve VS Code'da çalışırlar, ancak tüm Markdown işlemcilerde değil. Sözdizimi, sütunları ayırmak için boru karakterleri ve başlığı işaretlemek için tire ayırıcı satırı kullanır. Ayırıcı satırdaki iki nokta üst üste, sütun hizalamasını kontrol eder.

| Feature              | CommonMark | GFM       |
| -------------------- | :--------: | :-------: |
| Headings             | ✅         | ✅        |
| Bold / Italic        | ✅         | ✅        |
| Fenced code blocks   | ✅         | ✅        |
| Tables               | ❌         | ✅        |
| Task lists           | ❌         | ✅        |
| Strikethrough        | ❌         | ✅        |
| Autolinks            | ✅         | ✅ (ext.) |

Sütun hizalaması ayırıcı satırda belirlenir. :--- sola hizalar (varsayılan). ---: sağa hizalar. :---: ortalar. Kaynakta görsel olarak hizalanmış görünmeleri için sütunları boşluklarla doldurmak zorunda değilsiniz — bu kosmetiktir ve render edilmiş çıktı üzerinde hiçbir etkisi yoktur. Her satırın başındaki ve sonundaki borular teknik olarak GFM'de isteğe bağlıdır, ancak bunları dahil etmek daha net bir stildir.

Alıntılar

Alıntılar her satıra > öneki ekler. İç içe geçmiş alıntılar >> kullanır. Bir alıntıya başka Markdown öğeleri — başlıklar, listeler, kod blokları — ekleyebilirsiniz, bu da onları belgelerdeki çağrı kutuları için kullanışlı kılar.

> **Note:** As of Node.js 18, the `fetch` API is available globally
> without importing anything. No more `node-fetch` dependency.

> This is a quote that spans
> multiple lines.
>
> And has a second paragraph.

> Outer quote.
>
> > Nested quote — useful for "quoting a quote" in changelogs
> > or spec discussions.

<!-- Blockquote containing a code block — useful for quoting error messages -->
> The migration failed with:
>
> ```
> ERROR: relation "users" already exists
> ```

Yatay Çizgiler, Satır Sonları ve Kaçış

Bu üç özellik, kuralları bilene kadar davranışları bir hata gibi göründüğünden insanları zorlar. Yatay çizgiler, sert satır sonları ve backslash kaçışının hepsinin açık olmayan belirli sözdizimi vardır.

<!-- Horizontal rules: three or more of ---, ***, or ___ on their own line -->
---
***
___

<!-- All three render as <hr>. Most common style is --- -->

<!-- Hard line breaks: end a line with two trailing spaces, or use backslash -->
First line with two trailing spaces
Second line (rendered as a new line, not a new paragraph)

First line with backslash\
Second line (same result)

<!-- A single newline in Markdown source is NOT a line break — it's a space.
     Two newlines = a paragraph break. -->

<!-- Backslash escaping: put  before any Markdown character to render it literally -->
*This is not italic*
# This is not a heading
[Not a link](not-a-url)
`Not inline code`

<!-- Characters that can be escaped -->
\ ` * _ { } [ ] ( ) # + - . !

Markdown'da HTML

Çoğu Markdown işlemcisi ham HTML'yi değiştirmeden geçirir ve bu, saf Markdown sözdiziminin ifade edemeyeceği bir avuç kullanışlı kalıbın kilidini açar. GitHub README'lerinde en yaygın kullanım durumu, daraltılabilir <details>/<summary> bölümüdür. Diğer kullanışlı olanlar: klavye kısayolları için <kbd> ve hassas çapa bağlantıları için başlıklardaki özel id nitelikleri.

<!-- Collapsible section — very common in GitHub READMEs -->
<details>
<summary>Click to expand: Advanced configuration options</summary>

You can override the defaults by creating a `config.local.json` file
in the project root. Supported keys:

| Key        | Default | Description             |
| ---------- | ------- | ----------------------- |
| `port`     | 3000    | Dev server port         |
| `logLevel` | `info`  | One of debug/info/warn  |

</details>

<!-- Keyboard shortcuts -->
Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> to open the command palette.

<!-- Custom heading ID for anchor links -->
<h2 id="configuration-reference">Configuration Reference</h2>

<!-- Link to that heading from anywhere -->
See the [Configuration Reference](#configuration-reference).

Önemli bir uyarı: <details> bloğu, bu gövde içeriği Markdown içeriyorsa </summary> kapanış etiketi ile gövde içeriği arasında boş bir satır gerektirir. Boş satır olmadan, içindeki Markdown ayrıştırılmaz — ham metin olarak render edilir. Markdown dosyalarınızı Markdown Biçimlendirici aracıyla temizleyebilir ve biçimlendirebilirsiniz.

Sonuç

Bu, tam sözdizimini kapsar — standart CommonMark ve geliştiricilerin günlük kullandığı GFM uzantıları. Uç durumlar için yetkili söz için, CommonMark spesifikasyonu ve GFM spesifikasyonu yalnızca referans dökümleri değil, okunabilir belgelerdir. CommonMark hızlı referansı kullanışlı tek sayfalık bir özettir. Markdown Guide temel sözdizimi ve genişletilmiş sözdizimi sayfaları da örneklerin yanında daha fazla nesir açıklaması istiyorsanız iyi organize edilmiştir. Commit etmeden önce Markdown'ınızın tam olarak nasıl görüneceğini görmek istediğinizde, Markdown Önizleme aracı tarayıcınızda canlı olarak render eder. Bir belgedeki tutarsız biçimlendirmeyi temizlemek için Markdown Biçimlendirici, başlık stillerini, liste işaretçilerini ve boşlukları normalleştirir. Markdown çıktısından temiz HTML üretmek için HTML Biçimlendirici, Markdown işlemcisinin ürettiği her şeyi güzelleştirir.