guide/06-markdown-basics/readme.md

# 🇬🇧 06 — Markdown basics

Markdown is plain text with a few punctuation rules. Files ending in `.md` are rendered automatically, and a file named `readme.md` is shown on its folder page.

## Headings

```markdown
# Title
## Section
### Subsection
```

Leave a blank line before and after a heading.

## Text

```markdown
**bold**  *italic*  ~~struck through~~  `code`
```

A single line break is ignored. To start a new paragraph, leave a blank line.

## Lists

```markdown
- first
- second
  - nested (two spaces)

1. step one
2. step two
```

## Links

```markdown
[KabaForge](https://forge.kabaforce.com)
[chapter 04](../04-create-directory/readme.md)
```

Links to files in the same repository are best written as relative paths — they keep working on every branch.

## Code

Fenced blocks keep spacing and add colours. Write the language after the opening fence:

~~~markdown
```bash
git status
```
~~~

## Tables

```markdown
| Column | Meaning |
|--------|---------|
| `main` | default branch |
| `.md`  | Markdown file |
```

## Quotes, rules, tasks

```markdown
> A quoted note.

---

- [x] done
- [ ] not done yet
```

## Practical tips

- Preview before committing: the **Preview** tab in the editor renders exactly what others will see.
- Keep one sentence per line in long documents — differences between versions stay readable.
- Emoji work directly: 📌 ✅ ⚠️

---

# 🇹🇷 06 — Markdown temelleri

Markdown, birkaç noktalama kuralı olan düz metindir. `.md` ile biten dosyalar otomatik olarak biçimlendirilir; `readme.md` adlı dosya bulunduğu klasörün sayfasında gösterilir.

## Başlıklar

```markdown
# Başlık
## Bölüm
### Alt bölüm
```

Başlığın öncesinde ve sonrasında boş satır bırakın.

## Metin

```markdown
**kalın**  *italik*  ~~üstü çizili~~  `kod`
```

Tek satır sonu yok sayılır. Yeni paragraf için boş satır bırakın.

## Listeler

```markdown
- birinci
- ikinci
  - iç madde (iki boşluk)

1. birinci adım
2. ikinci adım
```

## Bağlantılar

```markdown
[KabaForge](https://forge.kabaforce.com)
[bölüm 04](../04-create-directory/readme.md)
```

Aynı depodaki dosyalara göreli yolla bağlanmak en iyisidir — her dalda çalışmaya devam eder.

## Kod

Çitli bloklar boşlukları korur ve renk verir. Açılış çitinden sonra dili yazın:

~~~markdown
```bash
git status
```
~~~

## Tablolar

```markdown
| Sütun  | Anlamı |
|--------|--------|
| `main` | varsayılan dal |
| `.md`  | Markdown dosyası |
```

## Alıntı, çizgi, görev listesi

```markdown
> Alıntılanmış not.

---

- [x] bitti
- [ ] henüz bitmedi
```

## Pratik ipuçları

- İşlemeden önce önizleyin: editördeki **Önizleme** sekmesi, başkalarının göreceğinin aynısını gösterir.
- Uzun belgelerde her cümleyi ayrı satıra yazın — sürümler arası farklar okunaklı kalır.
- Emoji doğrudan çalışır: 📌 ✅ ⚠️