158 lines
2.9 KiB
Markdown
158 lines
2.9 KiB
Markdown
# 🇬🇧 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: 📌 ✅ ⚠️
|