Temel Markdown kullanımı için söz dizimi kılavuzu
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018
Önemli
Platformunuzda kullanılabilen içeriği görüntülemek için, içindekiler tablosunun üzerinde bulunan sürüm seçiciden bu makalenin doğru sürümünü seçtiğinizden emin olun. Özellik desteği, Azure DevOps Services veya Team Foundation Server'dan (TFS) yeniden adlandırılan Azure DevOps Server şirket içi sürümüne bağlı olarak farklılık gösterir.
Hangi şirket içi sürümü kullandığınızı öğrenmek için bkz . Azure DevOps platformunuzu ve sürümünüzü arama
Burada, Azure DevOps özelliklerinde Markdown'ı kullanmaya yönelik bazı temel Markdown söz dizimi kılavuzlarını ve belirli yönergeleri bulabilirsiniz. Hem yaygın Markdown kurallarını hem de GitHub özellikli uzantıları kullanabilirsiniz.
Doğru zamanda doğru rehberliğe sahip olmak başarı için kritik öneme sahiptir. Proje sayfalarınıza, BENİOKU dosyalarınıza, panolarınıza ve çekme isteği açıklamalarınıza zengin biçimlendirme, tablolar ve resimler eklemek için Markdown'ı kullanın.
Wiki sayfaları için daha fazla desteklenen söz dizimi için bkz. Wiki Markdown kılavuzu.
Markdown kullanarak aşağıdaki alanlarda rehberlik sağlayabilirsiniz:
- Project Wiki
- Panoya eklenen Markdown pencere öğesi
- Proje sayfası veya Hoş Geldiniz sayfaları
- Depo BENİOKU dosyaları
- Çekme isteği (PR) açıklamaları
- Bitti tanımı (Kanban panosu)
Not
Kod depolarında zengin Markdown işleme, TFS 2018.2 ve sonraki sürümlerde desteklenir. Kod depolarında zengin README.md dosyaları oluşturabilirsiniz. MD dosyalarının kod depolarındaki Markdown işlemesi HTML etiketlerini, blok tırnaklarını, emojileri, görüntü yeniden boyutlandırmayı ve matematiksel formülleri destekler. Wiki'de Markdown işleme ve koddaki MD dosyalarında eşlik vardır.
Önemli
Markdown söz dizimlerinin tümü tüm özelliklerde desteklenmez. Bu makaledeki her bölüm, Desteklenen satırında desteklenen özellikleri ve söz dizimini tanımlar.
Üst Bilgiler
Desteklenen: Bitti | Tanımı Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Üst bilgileri kullanarak açıklamalarınızı yapılandırın. Üst bilgiler daha uzun açıklamalar oluşturarak okunmalarını daha kolay hale getirir.
Bir başlık ayarlamak için satıra kare karakteriyle #
başlayın. Daha fazla karma karakter içeren bir satır başlatarak açıklamalarınızı alt başlıklarla düzenleyin. Örneğin, ####
. En fazla altı başlık düzeyi kullanabilirsiniz.
Örnek:
# This is a H1 header
## This is a H2 header
### This is a H3 header
#### This is a H4 header
##### This is a H5 header
Sonuç:
Paragraflar ve satır sonları
Desteklenen: Bitti | Tanımı Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Metninizi paragraflara veya satır sonlarına bölerek daha kolay okunmasını sağlayın.
Çekme istekleri
Çekme isteği açıklamalarında, satır sonu eklemek ve metni yeni satıra başlatmak için Enter'ı seçin.
Örnek - çekme isteği açıklaması:
Add lines between your text with the **Enter** key. Your text gets better spaced and makes it easier to read.
Sonuç:
Enter tuşuyla metninizin arasına satırlar ekleyin.
Metniniz daha iyi aralıklı hale gelir ve okunmasını kolaylaştırır.
Markdown dosyaları veya pencere öğeleri
Markdown dosyası veya pencere öğesinde, satır sonu öncesinde iki boşluk girin ve ardından Yeni bir paragraf başlatmak için Enter'ı seçin.
Örnek - Markdown dosyası veya pencere öğesi:
Add two spaces before the end of the line, and then select **Enter**.(space, space, Enter) A space gets added in between paragraphs.
Sonuç:
Satırın sonuna iki boşluk ekleyin ve enter tuşuna basın.
Paragrafların arasına boşluk eklenir.
Alıntı Blokları
Desteklenen: Bitti | Tanımı Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Açıklamanızın veya metninizin bağlamını ayarlamak için önceki açıklamaları veya metni alıntıla.
Metnin tek satırlarını metinden önce olacak >
şekilde tırnak içine alın. Tırnak içine alınmış metni iç içe kullanmak için çok sayıda >
karakter kullanın.
Birçok satır arasında aynı düzey kullanılarak metin satırlarının >
tırnak içine alma blokları.
Örnek:
> Single line quote >> Nested quote >> multiple line >> quote
Sonuç:
Yatay kurallar
Desteklenen: Bitti | Tanımı Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Yatay kural eklemek için, çizgi dizisi ---
olan bir çizgi ekleyin. öğesini içeren ---
satırın üzerindeki satır boş olmalıdır.
Örnek:
above ---- below
Sonuç:
Yukarıda
Aşağıda
Vurgu (kalın, italik, üstü çizili)
Desteklenen: Bitti | Tanımı Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Karakterlere kalın, italik veya üstü çizgili biçimler uygulayarak metni vurgulayabilirsiniz:
- İtalik stil uygulamak için: metnin başına ve sonuna bir yıldız işareti
*
veya alt çizgi_
koyun - Kalın stil uygulamak için: metnin başına ve sonuna çift yıldız
**
koyun. - Üstü çizili stil uygulamak için: metnin başına ve sonuna çift tilde karakteri
~~
koyun.
Metne vurgu uygulamak için bu öğeleri birleştirin.
Not
Metnin altını çizmeyi destekleyen markdown söz dizimi yoktur. Wiki sayfasında, altı çizili metin oluşturmak için HTML <u>
etiketini kullanabilirsiniz. Örneğin, <u>underlined text</u>
altı çizili metin verir.
Not
Metnin altını çizmeyi destekleyen markdown söz dizimi yoktur. TFS 2018.2 ve sonraki sürümlerin wiki sayfasında, altı çizili metin oluşturmak için HTML <u>
etiketini kullanabilirsiniz. Örneğin, <u>underlined text</u>
altı çizili metin verir.
Örnek:
Use _emphasis_ in comments to express **strong** opinions and point out ~~corrections~~ **_Bold, italicized text_** **~~Bold, strike-through text~~**
Sonuç:
Use emphasis in comments to express strong opinions and point out corrections
Kalın, italik metinKalın, üstü çizili metin
Kod vurgulama
Desteklenen: Çekme İstekleri | BENİOKU dosyaları | Wikis
Kod vurgulama bloklarını kullanarak önerilen kod kesimlerini vurgulayın.
Bir kod aralığını belirtmek için, bloğun hem başında hem de sonunda yeni bir satırda üç ters tırnak işaretiyle (```
) sarmalayın. Kodu satır içi olarak belirtmek için, tek bir ters tırnak (`
) ile sarmalayın.
Not
Markdown pencere öğesi içinde girilen kod vurgulama, kodu önceden biçimlendirilmiş düz metin olarak işler.
Örnek:
``` sudo npm install vsoagent-installer -g ```
Sonuç:
sudo npm install vsoagent-installer -g
Örnek:
To install the Microsoft Cross Platform Build & Release Agent, run the following: `$ sudo npm install vsoagent-installer -g`.
Sonuç:
Microsoft Platformlar Arası Derleme & Yayın Aracısı'nı yüklemek için şu komutu çalıştırın: $ sudo npm install vsoagent-installer -g
.
Markdown dosyası içinde, satırın başında dört boşluk bulunan metin otomatik olarak kod bloğuna dönüştürülür.
Highlightjs, sürüm v9.10.0'da desteklenen dillerden herhangi birinde söz dizimi vurgulama özelliğini etkinleştirmek için kod bloğu için bir dil tanımlayıcısı ayarlayın.
``` language code ```
Diğer örnekler:
``` js const count = records.length; ```
const count = records.length;
``` csharp Console.WriteLine("Hello, World!"); ```
Console.WriteLine("Hello, World!");
Tables
Desteklenen: Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Yapılandırılmış verileri tablolarla düzenleyin. Tablolar özellikle işlev parametrelerini, nesne yöntemlerini ve açıklama eşlemesini net bir adla açıklayan diğer verileri tanımlamak için kullanışlıdır. Çekme istekleri, wiki ve BENİOKU dosyaları ve Markdown pencere öğeleri gibi Markdown dosyalarındaki tabloları biçimlendirebilirsiniz.
- Her tablo satırını kendi satırına yerleştirin.
- Kanal karakterini
|
kullanarak tablo hücrelerini ayırın. - Tablo içinde bir boru karakteri kullanmak için ters eğik çizgiyle
\|
kaçış karakteri kullanmanız gerekir. - Tablonun ilk iki satırı, sütun başlıklarını ve tablodaki öğelerin hizalamasını ayarlar.
- Sütun hizalamasını (
:
sol, orta, sağ) belirtmek için tabloların üst bilgisini ve gövdesini bölerken iki nokta () kullanın. - Yeni bir satır başlatmak için HTML kesme etiketini () kullanın (
<br/>
Wiki içinde çalışır ancak başka bir yerde çalışmaz). - Her satırı bir CR veya LF ile sonlandırdığınızdan emin olun.
- Tablo hücresinde bahsedilen iş öğesi veya çekme isteği (PR) öncesinde ve sonrasında boş alan girmelisiniz.
Örnek:
| Heading 1 | Heading 2 | Heading 3 |
|-----------|:-----------:|-----------:|
| Cell A1 | Cell A2 | Cell A3 |
| Cell B1 | Cell B2 | Cell B3<br/>second line of text |
Sonuç:
Heading 1 | Heading 2 | Heading 3 |
---|---|---|
Cell A1 | Cell A2 | Cell A3 |
Cell B1 | Cell B2 | Cell B3 second line of text |
Listeler
Desteklenen: Bitti | Tanımı Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
İlgili öğeleri listelerle düzenleyin. Numaralar içeren sıralı listeler veya yalnızca madde işaretleriyle sıralanmamış listeler ekleyebilirsiniz.
Sıralı listeler her bir liste öğesinde bir sayı ve ardından bir noktayla başlar. Sırasız listeler -
ile başlar. Her liste öğesine yeni bir satırda başlayın. Markdown dosyasında veya pencere öğesinde, yeni bir paragrafa başlamak için satır sonu öncesinde iki boşluk girin veya yeni paragrafa başlamak için art arda iki satır sonu girin.
Sıralı veya numaralı listeler
Örnek:
1. First item.
1. Second item.
1. Third item.
Sonuç:
- First item.
- Second item.
- Third item.
Madde işaretli listeler
Örnek:
- Item 1
- Item 2
- Item 3
Sonuç:
- Item 1
- Item 2
- Item 3
İç içe listeler
Örnek:
1. First item.
- Item 1
- Item 2
- Item 3
1. Second item.
- Nested item 1
- Further nested item 1
- Further nested item 2
- Further nested item 3
- Nested item 2
- Nested item 3
Sonuç:
- First item.
- Item 1
- Item 2
- Item 3
- Second item.
- Nested item 1
- Daha fazla iç içe öğe 1
- Daha fazla iç içe öğe 2
- Daha fazla iç içe öğe 3
- Nested item 2
- Nested item 3
- Nested item 1
Bağlantılar
Desteklenen: Bitti | Tanımı Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Çekme isteği açıklamalarında ve wiki'lerinde HTTP ve HTTPS URL'leri otomatik olarak bağlantı olarak biçimlendirilir. Anahtarı ve iş öğesi kimliğini girip listeden # iş öğesini seçerek iş öğelerine bağlanabilirsiniz.
Ters eğik çizgi (\
) ön ekiyle # iş öğeleri için otomatik önerilerden kaçının. Bu eylem, onaltılık renk kodları için kullanmak # istiyorsanız yararlı olabilir.
Markdown dosyaları ve pencere öğelerinde standart Markdown bağlantı söz dizimini kullanarak URL'niz için metin köprüleri ayarlayabilirsiniz:
[Link Text](Link URL)
Aynı Git veya TFVC deposundaki başka bir Markdown sayfasına bağlandığınızda, bağlantı hedefi göreli bir yol veya depodaki mutlak bir yol olabilir.
Hoş Geldiniz sayfaları için desteklenen bağlantılar:
- Göreli yol:
[text to display](target.md)
- Git'te mutlak yol:
[text to display](/folder/target.md)
- TFVC'de mutlak yol:
[text to display]($/project/folder/target.md)
- URL:
[text to display](http://address.com)
Markdown pencere öğesi için desteklenen bağlantılar:
- URL:
[text to display](http://address.com)
Wiki için desteklenen bağlantılar:
- Wiki sayfalarının mutlak yolu:
[text to display](/parent-page/child-page)
- URL:
[text to display](http://address.com)
Not
kullanan file://
dosya paylaşımlarıyla ilgili belgelerin bağlantıları 2017.1 ve sonraki sürümlerde desteklenmez. Bu kısıtlama güvenlik amacıyla uygulanmıştır.
Hoş Geldiniz sayfasından veya Markdown pencere öğesinden göreli bağlantıları belirtme hakkında bilgi için bkz . Kaynak denetimi göreli bağlantıları.
Örnek:
[C# language reference](/dotnet/csharp/language-reference/)
Sonuç:
Kaynak denetimi göreli bağlantıları
Kaynak denetim dosyalarının bağlantıları Hoş Geldiniz sayfasında mı yoksa Markdown pencere öğesinde mi belirttiğinize bağlı olarak farklı yorumlanır. Sistem göreli bağlantıları aşağıdaki gibi yorumlar:
- Hoş Geldiniz sayfası: Karşılama sayfasının bulunduğu kaynak denetim deposunun köküne göre
- Markdown pencere öğesi: takım projesi koleksiyonu URL tabanına göre
Örneğin:
Hoş Geldiniz sayfası | Markdown pencere öğesi eşdeğeri |
---|---|
/BuildTemplates/AzureContinuousDeploy.11.xaml | /DefaultCollection/Fabrikam Fiber/_versionControl#path=$/Tfvc Welcome/BuildTemplates/AzureContinuousDeploy.11.xaml |
./page-2.md | /DefaultCollection/Fabrikam Fiber/_versionControl#path=$/Tfvc Hoş Geldiniz/page-2.md |
Yer işareti bağlantıları
Markdown dosyalarında, tutturucu kimlikleri HTML olarak işlendiğinde tüm başlıklara atanır. Kimlik, boşlukların çizgilerle (-) değiştirildiği ve tüm harflerin küçük olduğu başlık metnidir. Genel olarak, aşağıdaki kurallar geçerlidir:
- Dosya adı içindeki noktalama işaretleri ve baştaki boşluklar yoksayılır
- Büyük harfler küçük harfe dönüşür
- Harfler arasındaki boşluklar kısa çizgilere dönüşür (-)
Örnek:
###Link to a heading in the page
Sonuç:
Bir bölümün yer işareti bağlantısına ait söz dizimi...
[Link to a heading in the page](#link-to-a-heading-in-the-page)
Kimliğin tümü küçük harftir ve bağlantı büyük/küçük harfe duyarlıdır, bu nedenle başlığın kendisi büyük harf kullansa bile küçük harf kullandığınızdan emin olun.
Başka bir Markdown dosyasındaki başlıklara da başvurabilirsiniz:
[text to display](./target.md#heading-id)
Wiki'de başka bir sayfadaki başlığa da başvurabilirsiniz:
[text to display](/page-name#section-name)
Görüntüler
Desteklenenler: Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Sorunları vurgulamak veya işleri daha ilginç hale getirmek için, çekme isteklerinizin aşağıdaki yönlerine resimler ve animasyonlu GIF'ler ekleyebilirsiniz:
- Yorumlar
- Markdown dosyaları
- Wiki sayfaları
Görüntü eklemek için aşağıdaki söz dizimini kullanın:

Örnek:

Sonuç:
Görüntü dosyasının yolu, bağlantıdaki başka bir Markdown dosyasının yolu gibi git veya TFVC'de göreli bir yol veya mutlak yol olabilir.
- Göreli yol:

- Git'te mutlak yol:

- TFVC'de mutlak yol:

- Resmi yeniden boyutlandır:
IMAGE_URL =WIDTHxHEIGHT
Not
Eşittir işaretinden önce bir boşluk eklediğinizden emin olun.
- Örnek:

- Height değerini dışarıda bırakarak yalnızca WIDTH değerini belirtmek de mümkündür:
IMAGE_URL =WIDTHx
- Örnek:
Denetim listesi veya görev listesi
Desteklenen: Çekme İstekleri | Wikis
Basit görev listeleri çekme isteği oluşturucusu veya gözden geçireni olarak çekme isteği açıklamasında veya wiki sayfasında yapılacaklar listelerinizin ilerleme durumunu izlemenin harika yollarıdır. Başlamak veya biçimi seçili metne uygulamak için Markdown araç çubuğunu seçin.
Denetim listelerini desteklemek için veya [x]
kullanabilirsiniz[ ]
. Denetim listesinden önce -<space>
veya 1.<space>
(herhangi bir sayı) ekleyin.
Örnek - Görev listesi Markdown'ı vurgulanan listeye uygulama
Kutuları işaretleyerek öğeleri tamamlandı olarak işaretlemek için, görev listesi ekledikten sonra markdown'ı el ile düzenlemeniz ve söz dizimini değiştirmeniz gerekir.
Örnek - Listeyi görev listesi olarak biçimlendirme
- [ ] A - [ ] B - [ ] C - [x] A - [x] B - [x] C
Sonuç:

Not
Tablo hücresinde denetim listesi desteklenmez.
Emoji
Desteklenen: Çekme İstekleri | Wikis
Çekme isteği açıklamalarında ve wiki sayfalarında, karakter eklemek ve istekteki açıklamalara tepki vermek için emojileri kullanabilirsiniz. Metninizde eşleşen bir emoji elde etmek için kendinizi karakterlerle çevrelenmiş :
olarak girin. Emojilerin tamamını destekliyoruz.
Örnek:
:smile: :angry:
Sonuç:
Emojilerden kaçmak için bunları ' karakterini kullanarak içine alın.
Örnek:
`:smile:` `:)` `:angry:`
Sonuç:
:smile:
:)
:angry:
Belirli veya değişmez karakterler girmek için Markdown söz dizimlerini yoksayma veya kaçış
Desteklenen: Bitti | Tanımı Markdown pencere öğesi | Çekme İstekleri | BENİOKU dosyaları | Wikis
Syntax
Örnek/notlar
Aşağıdaki karakterlerden birini eklemek için önek olarak \
(ters eğik çizgi) ekleyin.
\
Ters eğik çizgi
`
, backtick
_
Alt çizgi
{}
, küme ayraçları
[]
, köşeli ayraçlar
()
Parantez
#
, karma işareti
+
, artı işareti -
, eksi işareti (kısa çizgi) .
, nokta
!
, ünlem işareti *
, yıldız işareti
Özel karakter eklemeye ilişkin bazı örnekler:
\ almak için girin \\
_ elde etmek için \_
girin
Almak için girin \#
#
Almak için girin \(
(
almak için girin \.
.
Almak için girin \!
!
* almak için girin \*
Ekler
Desteklenen: Çekme İstekleri | Wikis
Çekme isteği açıklamalarında ve wiki sayfalarında, amacınızı göstermek veya önerilerinizin arkasında daha ayrıntılı bir neden göstermek için dosyalar ekleyebilirsiniz. Dosya eklemek için, dosyayı sürükleyip açıklama alanına veya wiki sayfası düzenleme deneyimine bırakın. Açıklama kutusunun sağ üst kısmındaki veya wiki sayfanızdaki biçim bölmesinden de ataş seçebilirsiniz.

Panonuzda bir resim varsa, panodan açıklama kutusuna veya wiki sayfasına yapıştırabilirsiniz ve doğrudan açıklama veya wiki sayfanıza işlenir.
Görüntü olmayan dosyaları eklemek, açıklamanızda dosyaya bir bağlantı oluşturur. Bağlantıda görüntülenen metni değiştirmek için köşeli ayraçlar arasındaki açıklama metnini güncelleştirin. Ekli görüntü dosyaları doğrudan açıklama veya wiki sayfalarınızda işlenir. Açıklamanızı veya wiki sayfanızı bir ekle kaydedin veya güncelleştirin. Ardından, ekli görüntüyü görebilir ve ekli dosyaları indirmek için bağlantıları seçebilirsiniz.
Ekler aşağıdaki dosya biçimlerini destekler:
Tür | Dosya biçimleri |
---|---|
Kod | CS (.cs), Genişletilebilir Biçimlendirme Dili (.xml), JavaScript Nesne Gösterimi (.json), Köprü Metni biçimlendirme Dili(.html, .htm), Katman (.lyr), Windows PowerShell betiği (.ps1), Roshal Arşivi (.rar), Uzak Masaüstü Bağlantısı (.rdp), Yapılandırılmış Sorgu Dili (.sql) - Not: Çekme isteği açıklamalarında kod eklerine izin verilmez |
Sıkıştırılmış dosyalar | ZIP (.zip) ve GZIP (.gz) |
Belgeler | Markdown (.md), Microsoft Office İletisi (.msg), Microsoft Project (.mpp), Word (.doc ve .docx), Excel (.xls, .xlsx ve .csv) ve PowerPoint (.ppt ve .pptx), metin dosyaları (.txt) ve PDF'ler (.pdf) |
Görüntüler | PNG (.png), GIF (.gif), JPEG (hem .jpeg hem de .jpg), Simgeler (.ico) |
Visio | VSD (.vsd ve .vsdx) |
Video | MOV (.mov), MP4 (.mp4) |
Not
Microsoft Office İletisi (.msg) dosyaları gibi çekme isteklerinde tüm dosya biçimleri desteklenmez.
Matematiksel notasyon ve karakterler
Desteklenen: Çekme İstekleri | Wikis
Wiki sayfalarında ve çekme isteklerinde hem satır içi hem de blok KaTeX gösterimini destekliyoruz. Aşağıdaki desteklenen öğelere bakın:
- Simgeleri
- Yunanca harfler
- Matematiksel işleçler
- Güçler ve endeksler
- Kesirler ve binomlar
- KaTeX tarafından desteklenen diğer öğeler
Matematiksel gösterim eklemek için, aşağıdaki örneklerde gösterildiği gibi matematiksel gösterimi satır içi ve $$
blok işaretiyle $
çevreleyin:
Not
Bu özellik, TFS 2018.2 veya sonraki sürümler için Wiki sayfalarında ve çekme isteklerinde desteklenir.
Örnek: Yunanca karakterler
$
\alpha, \beta, \gamma, \delta, \epsilon, \zeta, \eta, \theta, \kappa, \lambda, \mu, \nu, \omicron, \pi, \rho, \sigma, \tau, \upsilon, \phi, ...
$
$\Gamma, \Delta, \Theta, \Lambda, \Xi, \Pi, \Sigma, \Upsilon, \Phi, \Psi, \Omega$
Sonuç:
Örnek: Cebirsel gösterimi
Area of a circle is $\pi r^2$
And, the area of a triangle is:
$$
A_{triangle}=\frac{1}{2}({b}\cdot{h})
$$
Sonuç:
Örnek: Toplamlar ve İntegraller
$$
\sum_{i=1}^{10} t_i
$$
$$
\int_0^\infty \mathrm{e}^{-x}\,\mathrm{d}x
$$
Sonuç: