Önceki

Sonraki

Markdown nedir?

Tamamlandı

Markdown, içerik oluşturucularını HTML yükünden koruyarak içerik düzenlemeye yalın bir yaklaşım sunan bir işaretleme dilidir. HTML, içeriği tam amaçlandığı şekilde işlemek için mükemmel olsa da, çok alan kaplar ve küçük ölçüde çalışmak için bile zor olabilir. Markdown’ın ortaya çıkmasıyla birlikte, içerik açıklaması için HTML’in gücü ve düzenleme için düz metin kolaylığı arasında büyük bir dengeleme tercihi yapılması gerekti.

Bu ünitede Markdown'ın yapısını ve söz dizimini ele alacağız. GitHub özelliklerini içerikle tümleştirmenize olanak tanıyan söz dizimi uzantıları olan GitHub Flavored Markdown (GFM) özelliklerini de ele alacağız.

Not

Bu ünite, Markdown ile ilgili size bir fikir vermesi için tasarlanmıştır. Daha ayrıntılı bir inceleme için bu modülün sonundaki Özet ünitesindeki "Markdown söz dizimi açıklaması" ve "GitHub Flavored Markdown Belirtimi" makalelerine başvurun.

Metni vurgula

GitHub'da iletişimin en önemli kısmı genellikle metnin kendisidir, ancak metnin bazı bölümlerinin diğerlerinden daha önemli olduğunu nasıl gösterirsiniz?

Metinde italik kullanmak, hedef metni tek yıldız işaretiyle () veya tek alt çizgiyle (*_ ) çevreleye kadar kolaydır. Bir vurguyu açtığınız karakterle kapatdığınızdan emin olun. Yıldız ve alt çizgi kullanımını nasıl birleştirdiğinize dikkatli olun. İşte birkaç örnek:

This is *italic* text.
This is also _italic_ text.

Bu italik bir metindir. Bu aynı zamanda italik metindir.

İki yıldız işareti () veya iki alt çizgi (**__ ) kullanarak kalın metin oluşturun.

This is **bold** text.
This is also __bold__ text.

Bu kalın bir metindir. Bu aynı zamanda kalın metindir.

Farklı vurguları da birlikte kullanabilirsiniz.

_This is **italic and bold** text_ using a single underscore for italic and double asterisks for bold.
__This is bold and *italic* text__ using double underscores for bold and single asterisks for italic. 

Bu, italik için tek bir alt çizgi ve kalın için çift yıldız işareti kullanan italik ve kalın metindir . Bu, kalın için çift alt çizgi ve italik için tek yıldız işareti kullanan kalın ve italik metindir .

Sabit yıldız işareti kullanmak için önüne bir kaçış karakteri koyun; GFM'de bu bir ters eğik çizgidir (\). Bu örnek, çıktıda alt çizgi ve yıldız işareti gösterilmesine neden olur.

\_This is all \*\*plain\*\* text\_.

_This tüm **düz** text_.

Başlıkları bildirme

HTML, <h1> etiketi gibi içerik başlıkları sağlar. Markdown’da bu, # sembolüyle desteklenir. 1’den 6’ya kadar her bir başlık düzeyi için tek bir # kullanmanız yeterlidir.

###### This is H6 text

Bu bir H6 metnidir

Resimlere ve sitelere bağlantı

Resim ve site bağlantıları benzer bir söz dizimi kullanır.

![Link an image.](/learn/azure-devops/shared/media/mara.png)

[Link to Microsoft Training](/training)

Microsoft Eğitimi bağlantısı

Liste oluşturma

Sıralı veya sırasız listeleri tanımlayabilirsiniz. Girinti yoluyla iç içe geçmiş öğeleri de tanımlayabilirsiniz.

• Sıralı listeler numaralarla başlar.
• Sıralanmamış listeler yıldız işareti veya tire (- ) kullanabilir.

Sıralı listenin Markdown'ını aşağıda bulabilirsiniz:

1. First
1. Second
1. Third

Sonuç.

1. First
2. Second
3. Üçüncü

- First
  - Nested
- Second
- Third

Sıralanmamış bir listenin Markdown'ı aşağıdadır:

• İlk
  • İç İçe
• Second
• Üçüncü

Tablo oluşturma

Önceki satırı üst bilgi olarak belirlemek üzere sütun sonları ve tireler (-) için bir kanallar| () bileşimini kullanarak tablolar oluşturabilirsiniz.

First|Second
-|-
1|2
3|4

First	Second
1	2
3	4

Teklif metni

Büyüktür (>) karakterini kullanarak blok alıntıları oluşturabilirsiniz.

> This is quoted text.

Bu alıntılanmış bir metindir.

Boşlukları satır içi HTML ile doldurma

Markdown tarafından desteklenmeyen bir HTML senaryosuyla karşılaşırsanız, bu HTML'yi satır içi olarak kullanabilirsiniz.

Here is a<br />line break

Bu bir
satır sonudur

Kodla çalışma

Markdown, backtick (') karakteriyle sınırlandırılmış satır içi kod bloklarıyla çalışmak için varsayılan davranış sağlar. Metin bu karakterle süslendiğinde kod olarak işlenir.

This is `code`.

Bu bir code öğesidir.

Birden çok satıra yayılan bir kod kesiminiz varsa, çitle çevrili bir kod bloğu oluşturmak için önce ve sonra üç ters köşe (''') kullanabilirsiniz.

```markdown
var first = 1;
var second = 2;
var sum = first + second;
```

var first = 1;
var second = 2;
var sum = first + second;

GFM, popüler diller için söz dizimi vurgulama özelliğiyle bu desteği genişletmektedir. Tek yapmanız gereken, ilk aksan işareti dizisinin parçası olarak dili belirtmektir.

```javascript
var first = 1;
var second = 2;
var sum = first + second;
```

var first = 1;
var second = 2;
var sum = first + second;

Çapraz bağlantı sorunları ve çekme istekleri

GFM, sorunlara ve çekme isteklerine bağlanmayı kolaylaştırmak için çeşitli kısa kod biçimlerini destekler. Bunu yapmanın en kolay yolu, #ID biçimini kullanmaktır; örn. #3602. GitHub, bu biçime yapıştırırsanız daha uzun bağlantıları otomatik olarak ayarlar. Ayrıca, başka araçlarla çalışıyorsanız veya diğer projeleri/dalları belirtmek istiyorsanız, izleyebileceğiniz ek kurallar da vardır.

Referans türü	Ham başvuru	Kısa bağlantı
Sorun veya çekme isteği URL’si	https://github.com/desktop/desktop/pull/3602	#3602
# ve sorun veya çekme isteği numarası	#3602	#3602
GH- ve sorun veya çekme isteği numarası	GH-3602	GH-3602
Username/Repository# ve sorun veya çekme isteği numarası	desktop/desktop#3602	desktop/desktop#3602

Daha fazla bilgi için, bu modülün sonundaki Özet ünitesindeki "Otomatik bağlantılı başvurular ve URL'ler" makalesine bakın.

Belirli işlemeleri bağlama

Kimliğine yapıştırarak veya yalnızca güvenli karma algoritmasını (SHA) kullanarak işlemeye bağlanabilirsiniz.

Referans türü	Ham başvuru	Kısa bağlantı
İşleme URL’si	https://github.com/desktop/desktop/commit/
8304e9c271a5e5ab4fda797304cd7bcca7158c87	8304e9c
SHA	8304e9c271a5e5ab4fda797304cd7bcca7158c87	8304e9c
User@SHA	desktop@8304e9c271a5e5ab4fda797304cd7bcca7158c87	desktop@8304e9c
Kullanıcı adı/Repository@SHA	masaüstü/desktop@8304e9c271a5e5ab4fda797304cd7bcca7158c87	masaüstü/desktop@8304e9c

Kullanıcılardan ve ekiplerden bahsetme

Bir @ simge ve ardından GitHub kullanıcı adı yazdığınızda bu kişiye açıklama hakkında bir bildirim gönderilir. Buna "@mention" denir, çünkü bireyden söz ediyorsun. @mention ile bir kuruluş içindeki takımlardan da bahsedebilirsiniz.

@githubteacher

@githubteacher

Görev listelerini izleme

Aşağıdaki söz dizimini kullanarak sorunlar veya çekme istekleri içinde görev listeleri oluşturabilirsiniz. Bunlar, bir sorunun veya çekme isteğinin gövdesinde kullanıldığında ilerleme durumunu izlemek için kullanışlı olabilir.

- [x] First task
- [x] Second task
- [ ] Third task

Eğik çizgi komutları

Eğik çizgi komutları, karmaşık Markdown oluşturmak için gereken yazmayı azaltarak size zaman kazandırabilir.

Eğik çizgi komutunun desteklendiği sorunlarda, çekme isteklerinde veya tartışmalarda herhangi bir açıklama veya açıklama alanında eğik çizgi komutlarını kullanabilirsiniz.

Komut	Açıklama
/code	Markdown kod bloğu ekler. Dili siz seçersiniz.
/details	Daraltılabilir ayrıntı alanı ekler. Başlığı ve içeriği seçersiniz.
/saved-replies	Kaydedilmiş bir yanıt ekler. Kullanıcı hesabınız için kaydedilen yanıtlar arasından seçim yapabilirsiniz. Kaydedilen yanıtınıza eklerseniz %cursor% eğik çizgi komutu imleci bu konuma yerleştirir.
/table	Markdown tablosu ekler. Sütun ve satır sayısını seçersiniz.
/tasklist	Görev listesi ekler. Bu eğik çizgi komutu yalnızca bir sorun açıklamasında çalışır.
/template	Depodaki tüm şablonları gösterir. Eklenecek şablonu seçersiniz. Bu eğik çizgi komutu, sorun şablonları ve çekme isteği şablonu için çalışır.

Devam et