# Markdown ile yazın

Tanıdık Markdown ile taslak yazın ve bir PDF ya da iş birlikçiler için düzenlenebilir bir belge üretin.

Markdown, araştırma notları, raporlar ve ilk taslaklar için iyi çalışır. Oleafly ona özel bir biçimlendirme araç çubuğu ve bir Pandoc derleme yolu sunar; kaynak dosyaları uygulamanın dışında da kullanabilirsiniz.

## Bir rapor oluşturun

1. **Yeni proje → Şablon kullan → Boş Markdown belgesi**'ni seçin.
2. Projeye **Saha notları** adını verin ve `main.md` dosyasını açın.
3. Bu örneği yapıştırın, ardından **Yeniden derle**'yi seçin ya da **⌘Enter / Ctrl+Enter** tuşlarına basın.
4. Oleafly gereken bir motoru kurmayı önerirse kurulumu tamamlayın ve yeniden derleyin.

```markdown title="main.md"
---
title: "Field notes"
author: "Alex Chen"
date: ""
---

# Question

Does the revised procedure reduce measurement time?

## Method

1. Prepare the sample.
2. Repeat the measurement three times.
3. Record the elapsed time.

## Observations

| Run | Time (s) | Note |
| --- | --- | --- |
| 1 | 12 | First pass |
| 2 | 10 | Repeated pass |

The **mean time** will be compared with the baseline.
```

PDF'te bir başlık, başlıklar, numaralı bir liste ve bir tablo bulunmalıdır. İlk `---` satırı çiftinin arasındaki üst veri, belgenin başlığını ve yazarını belirler.

## Kaynak ve Görsel düzenleme

Araç çubuğunun başındaki anahtarın üç kipi vardır. **Kod**, Markdown kaynağını doğrudan düzenler. **Görsel**, başlıklar, paragraflar, listeler, bağlantılar, görseller ve tablolar için biçimlendirilmiş düzenleme sunar. **İkisi de**, kaynağı ve biçimlendirilmiş metni birlikte gösterir. Menüsünü açıp **Üst üste** ya da **Böl** seçin. Yeni projeler Kod kipinde açılır ve her proje, onu hangi kipte bıraktığınızı anımsar.

Altı çizili, vurgu, üst simge ve alt simge, Kod kipindeki Pandoc biçimlendirme denetimleridir. Düğmeleri Görsel kipte gizlidir. Üst veri, atıf sözdizimi ya da diğer kaynak yapılarıyla çalışırken Kod'u kullanın.

[Örnek kaynağı indirin](/examples/writing-example.md)

## Araç çubuğundaki her araç

Bir biçimlendirme denetimine tıklamadan önce metin seçin. Kod kipinde araçların çoğu seçimi sarmalar ya da bir yer tutucu ekler. Çubuğa sığmayan denetimlere ulaşmak için **Diğer biçimlendirme seçenekleri**'ni (`…`) açın.

### Kod / Görsel

**Kod**, **Görsel** ve **İkisi de** kipleri arasında geçiş yapın. Belge her kipte Markdown kaynağı olarak kalır.

### Geri al

Son düzenlemeyi geri alın. ⌘Z / Ctrl+Z.

### Yinele

Geri alınan bir düzenlemeyi geri getirin. **⌘Shift+Z / Ctrl+Shift+Z**.

### Başlık → Başlık

Başlık menüsünden **Başlık**'ı seçerek `# Title` ekleyin. Başlık metnini kendi başlığınızla değiştirin.

### Başlık → Alt bölüm

Başlık menüsünden **Alt bölüm**'ü seçerek `## Section` ekleyin. Başlık metnini kendi başlığınızla değiştirin.

### Başlık → İkinci düzey alt bölüm

Başlık menüsünden **İkinci düzey alt bölüm**'ü seçerek `### Subsection` ekleyin. Başlık metnini kendi başlığınızla değiştirin.

### Başlık → Üçüncü düzey alt bölüm

Başlık menüsünden **Üçüncü düzey alt bölüm**'ü seçerek `#### Subsubsection` ekleyin. Başlık metnini kendi başlığınızla değiştirin.

### Başlık → Küçük başlık

Başlık menüsünden **Küçük başlık**'ı seçerek `##### Minor heading` ekleyin. Başlık metnini kendi başlığınızla değiştirin.

### Başlık → Alt paragraf başlığı

Başlık menüsünden **Alt paragraf başlığı**'nı seçerek `###### Paragraph heading` ekleyin. Başlık metnini kendi başlığınızla değiştirin.

### Madde imli liste

Sırasız bir liste başlatın. `- Item`.

### Numaralı liste

Numaralı bir dizi başlatın. `1. Item`.

### Görev listesi

Kod kipinde bir görev ekleyin ve tamamlandığında `[ ]` işaretini `[x]` yapın. `- [ ] Task`.

### Alıntı bloğu

Bir alıntıyı kendi satırına yerleştirin. `> quoted text`.

### Kalın

Seçili metni vurgulayın. `**text**`; ⌘B / Ctrl+B.

### İtalik

Bir terimi vurgulayın. `*text*`; ⌘I / Ctrl+I.

### Üstü çizili

Metni geçersiz olarak işaretleyin. `~~text~~`.

### Satır içi kod

Bir dosya adını, komutu ya da tanımlayıcıyı biçimlendirin. Ters kesme işaretleriyle çevrelenmiş metin.

### Altı çizili

Kod kipinde bir ifade seçin. `[text]{.underline}`.

### Vurgu

Kod kipinde bir ifade seçin. `[text]{.mark}`.

### Üst simge

Kod kipinde üssü seçin. `^text^`.

### Alt simge

Kod kipinde alt simgeyi seçin. `~text~`.

Altı çizili ve vurgu, biçimlendirmenin PDF'e taşınabilmesi için Pandoc öznitelikleri kullanır. Belgeye ham HTML etiketleri eklemek yerine bu denetimleri kullanın.

### Bağlantı ekle

**Kod** kipinde: `[link text](url)` ekler. Her iki yer tutucuyu da değiştirin.

**Görsel** kipinde: **Bağlantı URL'si**'ni açar. Adresi girin ve seçiminize uygulayın. Metni bağlantı olmadan tutmak için **Bağlantıyı kaldır**'ı kullanın.

### Görsel ekle

**Kod** kipinde: `![caption](image-filename)` ekler. Yolu ve başlığı değiştirin.

**Görsel** kipinde: **Görsel dosyası**'nı açar. `figures/plot.png` gibi bir proje yolu girin ve uygulayın.

### Tablo ekle

**Kod** kipinde: Üç sütun, bir başlık satırı ve iki veri satırı ekler. Sütun adlarını ve hücreleri değiştirin.

**Görsel** kipinde: Aynı başlangıç boyutlarında düzenlenebilir bir tablo ekler.

### Diyagram çiz

[Diyagram oluşturucuyu](/docs/figures-diagrams/) Mermaid kipinde açar. Tuvale bir akış şeması çizin ya da Mermaid kodunu düzenleyin, sonra imlecin olduğu yere çitle çevrilmiş bir `mermaid` kod bloğu olarak eklemek için **Mermaid olarak ekle**'yi seçin. [Mermaid diyagramları](#mermaid-diagrams) bölümüne bakın.

### Belge içgörüleri

Belgenin başlıklarını, şekillerini, tablolarını, denklemlerini, etiketlerini, atıflarını ve yapılacaklarını kaynak sırasına göre listeler; her biri kendi satırına bağlantılıdır. Ayrıca üst veriden başlığı, yazarları, anahtar sözcükleri, tarihi ve özeti okur ve bunları bir başvuru formu için kopyalayabilir. [Belge içgörüleri](/docs/document-insights/) bölümüne bakın.

### Belge ayarları

Belge sınıfını, sayfa boyutunu, sütunları, kenar boşluklarını, gövde yazı tipini, yazı boyutunu, dili, satır aralığını ve bölüm numaralandırmasını değiştirir. Oleafly seçimlerinizi Pandoc'un okuduğu YAML üst verisine yazar ve dosyada üst veri yoksa bir üst veri bloğu ekler. [Belge ayarları](/docs/document-settings/#markdown) bölümüne bakın.

### Proje bilgileri

**Kod** kipinde: Proje istatistiklerini ve seçim bilgilerini gösterir.

**Görsel** kipinde: Görsel düzenleme yüzeyinin istatistiklerini gösterir.

### Bul

**Kod** kipinde: ⌘F / Ctrl+F ile etkin dosyanın aramasını açar.

**Görsel** kipinde: Kaynak araç çubuğundaki Bul düğmesi gizlidir.

Görseli, kendisine başvurmadan önce dosya ağacı üzerinden içe aktarın. Görsel yollarını belgeye göreli tutun; böylece kaynak arşivi başka bir bilgisayarda da çalışır.

## Denklemler ve kod blokları

Satır içi matematiği `$x^2$` olarak yazın. Blok denklemi iki çift dolar işaretinin arasına koyun:

```markdown
$$
\bar{x} = \frac{1}{n}\sum_{i=1}^{n}x_i
$$
```

Bir kod örneği için kodu üçlü ters kesme işaretleriyle çevreleyin ve dilini açılış çizgisinin ardına yazın. Bunlar kaynak yapılarıdır; Markdown araç çubuğunda ayrı bir denklem ya da çitle çevrilmiş kod bloğu düğmesi yoktur.

## Mermaid diyagramları

Araç çubuğunda **Diyagram çiz**'i seçerek diyagram oluşturucuda bir Mermaid akış şeması yapın. **Mermaid olarak ekle**, onu çitle çevrilmiş bir kod bloğu olarak ekler:

````markdown
```mermaid
flowchart LR
  A[Sample] --> B[Measure]
```
````

**İkisi de** kipinde biçimlendirilmiş taraf bloğu diyagram olarak çizer. PDF bir görsel gerektirdiğinden oluşturucu ayrıca işlenmiş bir PNG'yi `figures/mermaid-<hash>.png` konumuna kaydeder ve derleme bu görseli bloğun yerine koyar. Bu nedenle diyagram derlenmiş PDF'te de görünür. Bloğu daha sonra elle düzenlerseniz, oluşturucudan diyagramı yeniden ekleyip kaydedene kadar PDF kodu gösterir. [Markdown belgelerinde Mermaid](/docs/figures-diagrams/#mermaid-in-markdown-documents) bölümüne bakın.

## Atıflar ve kaynakça

`references.bib` dosyasını içe aktarın ya da oluşturun, YAML üst verisine `bibliography: references.bib` ekleyin ve var olan bir anahtara `[@citation-key]` ile atıf verin. Pandoc, biçimlendirilmiş atıflar ve bir kaynakça listesi üretmek için kaynakçayı kullanır.

[Kaynakları bulmak ve yönetmek →](/docs/citations/)

## İçe ve dışa aktarma

Var olan bir taslağı Markdown olarak tutmak için boş bir Markdown belgesi oluşturun, taslağı `main.md` dosyasına yapıştırın ve görselleriyle kaynakçasını içe aktarın. Kitaplığın ayrı **Markdown belgesi** içe aktarması şu anda bir taslağı LaTeX'e dönüştürür. [İçe aktarma yolları](/docs/import-project/) her iki yolu da açıklar.

PDF için derleyin ya da Word, HTML, Typst, LaTeX ya da düz metin oluşturmak için **Dışa aktar**'ı kullanın. Özgün Markdown dosyasını ve varlıklarını paylaşmak için bir kaynak ZIP kullanın. [Çalışmanızı dışa aktarın](/docs/export/) sırayı ve dönüştürülen dosyada yapılacak denetimleri ele alır.