Markdown → Sunum (Marp)

Marp ile Markdown'dan profesyonel PPTX, PDF ve HTML sunumları oluşturma rehberi.

1. Kurulum

bash
npm install -g @marp-team/marp-cli   # Global CLI
# veya
brew install marp-cli                 # macOS

2. Temel Yapı

markdown
---
marp: true
theme: default
paginate: true
---

# İlk Slayt

İçerik buraya

---

# İkinci Slayt

- Madde 1
- Madde 2

--- slaytları ayırır. Frontmatter seçenekleri:

yaml
---
marp: true
theme: default # default | gaia | uncover
size: 16:9 # 4:3 | 16:9
paginate: true
header: 'Şirket Adı'
footer: 'Gizli'
backgroundColor: '#fff'
---

3. CLI Kullanımı

bash
# PPTX
marp slides.md -o presentation.pptx

# PDF
marp slides.md -o presentation.pdf

# HTML
marp slides.md -o presentation.html

# Tema belirterek
marp slides.md --theme gaia -o presentation.pptx

# İzleme modu (geliştirme)
marp --watch slides.md

4. Tema Seçenekleri

Built-in temalar: default (temiz, minimal), gaia (renkli, modern), uncover (cesur, sunum odaklı).

markdown
<!-- class ile özel slayt stili -->
<!-- _class: lead -->        ← Ortalanmış başlık slaydı
<!-- _class: invert -->      ← Ters renkler

5. Animasyonlar (Fragments)

html
<section>
  <p class="fragment">İlk görünen</p>
  <p class="fragment fade-up">Sonra bu yukarı kayarak</p>
  <p class="fragment highlight-red">Vurgulanan</p>
</section>

Diğer stiller: fade-in, fade-out, fade-left, fade-right, strike.

6. İki Sütunlu Layout

markdown
---
marp: true
style: |
  .cols {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 2rem;
  }
---

# İki Sütun

<div class="cols">
<div>

## Sol

- Madde A
- Madde B

</div>
<div>

## Sağ

- Madde C
- Madde D

</div>
</div>

7. Konuşmacı Notları

markdown
# Başlık

İçerik

<!-- Burada konuşmacı notu. 'S' tuşuyla görüntülenir. -->

8. Auto-Animate

Aynı data-id değerine sahip elementler slaytlar arasında otomatik animasyon alır:

html
<!-- Slayt 1 -->
<div data-id="box" style="background: blue; padding: 20px;">Küçük</div>

<!-- Slayt 2 -->
<div data-id="box" style="background: green; padding: 60px; width: 400px;">Büyük</div>

9. Python Entegrasyonu

python
import subprocess
import tempfile
import os
from pathlib import Path

def markdown_to_pptx(
    md_content: str,
    output_path: str,
    theme: str = 'gaia'
) -> str:
    if '---\nmarp: true' not in md_content:
        md_content = f"---\nmarp: true\ntheme: {theme}\npaginate: true\n---\n\n" + md_content

    with tempfile.NamedTemporaryFile(mode='w', suffix='.md', delete=False, encoding='utf-8') as f:
        f.write(md_content)
        temp_path = f.name

    try:
        subprocess.run(['marp', temp_path, '-o', output_path], check=True)
        return output_path
    finally:
        os.unlink(temp_path)


def create_presentation(title: str, slides: list[dict], output_path: str) -> str:
    md = f"""---
marp: true
theme: gaia
paginate: true
---

<!-- _class: lead -->

# {title}

---

"""
    for slide in slides:
        md += f"# {slide['title']}\n\n"
        for point in slide.get('points', []):
            md += f"- {point}\n"
        md += "\n---\n\n"

    md += "<!-- _class: lead -->\n\n# Teşekkürler\n"
    return markdown_to_pptx(md, output_path)


# Kullanım
slides_data = [
    {'title': 'Problem', 'points': ['Manuel süreç', 'Yüksek hata oranı', 'Zaman kaybı']},
    {'title': 'Çözüm', 'points': ['Otomatik analiz', '%99 doğruluk', 'Anlık sonuç']},
]

create_presentation('Ürün Lansmanı', slides_data, 'sunum.pptx')

10. Teknik Sunum Şablonu

markdown
---
marp: true
theme: night
paginate: true
---

<!-- _class: lead -->

# API Tasarım İlkeleri

Mühendislik Ekibi — 2024

---

# Gündem

1. RESTful Tasarım
2. Versiyonlama
3. Hata Yönetimi
4. Örnekler

---

# Endpoint Tasarımı

| Metot  | URL     | Açıklama |
| ------ | ------- | -------- |
| GET    | /cv     | Liste    |
| POST   | /cv     | Oluştur  |
| GET    | /cv/:id | Detay    |
| DELETE | /cv/:id | Sil      |

---

# Hata Yanıtı

\`\`\`json
{
"error": "CV_NOT_FOUND",
"message": "İstenen CV bulunamadı",
"statusCode": 404
}
\`\`\`

---

<!-- _class: lead -->

# Sorular?

api-destek@example.com

11. Kısıtlamalar

Marp bazı PowerPoint özelliklerini desteklemiyor: karmaşık geçiş animasyonları, video yerleştirme, izleyici etkileşimi (anket vb.), tracked changes. Bu özellikler gerekiyorsa Google Slides veya PowerPoint native önerilir.