Markdown başvurularını öğrenme

Bu makalede , Microsoft Learn için Markdown yazmaya yönelik alfabetik bir başvuru sağlanır.

Markdown , düz metin biçimlendirme söz dizimi içeren basit bir işaretleme dilidir. Microsoft Learn platformu, Markdig ayrıştırma altyapısı aracılığıyla ayrıştırılan CommonMark uyumlu Markdown'u destekler. Microsoft Learn, Microsoft Learn sitesinde daha zengin içerik sağlayan özel Markdown uzantılarını da destekler.

Markdown yazmak için herhangi bir metin düzenleyicisini kullanabilirsiniz, ancak Learn Yazma Paketi ile Visual Studio Code öneririz. Learn Yazma Paketi, Makalelerinizin Microsoft Learn'de işlendiğinde nasıl görüneceğini görmenize olanak tanıyan düzenleme araçları ve önizleme işlevselliği sağlar.

Uyarılar (Not, İpucu, Önemli, Dikkat, Uyarı)

Uyarılar, Microsoft Learn'de içeriğin önemini belirten renkler ve simgelerle işlenen blok tırnakları oluşturmaya yönelik bir Markdown uzantısıdır.

Notlardan, ipuçlarından ve önemli kutulardan kaçının. Okuyucular bunları atlama eğilimindedir. Bu bilgileri doğrudan makale metnine koymak daha iyidir.

Uyarıları kullanmanız gerekiyorsa, bunları makale başına bir veya iki ile sınırlayın. Bir makalede hiçbir zaman birden çok not yan yana olmamalıdır.

Aşağıdaki uyarı türleri desteklenir:

> [!NOTE]
> Information the user should notice even if skimming.

> [!TIP]
> Optional information to help a user be more successful.

> [!IMPORTANT]
> Essential information required for user success.

> [!CAUTION]
> Negative potential consequences of an action.

> [!WARNING]
> Dangerous certain consequences of an action.

Bu uyarılar Microsoft Learn'de şöyle görünür:

Not

Information the user should notice even if skimming.

İpucu

Optional information to help a user be more successful.

Önemli

Essential information required for user success.

Dikkat

Negative potential consequences of an action.

Uyarı

Bir eylemin kesin tehlikeli sonuçları.

Açılı ayraçlar

Dosyanızdaki metinde açılı ayraçlar kullanıyorsanız (örneğin, bir yer tutucuyu belirtmek için), açılı ayraçları el ile kodlamanız gerekir. Aksi takdirde Markdown bunların HTML etiketleri olması gerektiğini düşünür.

Örneğin, veya \<script name>olarak <script name> kodla<script name>.

Açılı ayraçların satır içi kod olarak biçimlendirilmiş metinde veya kod bloklarında kaçış karakteri olması gerekmez.

Kesme işareti ve tırnak işaretleri

Word dosyasından Markdown editörüne bir şey kopyalarsanız kopyaladığınız metin “akıllı” (kıvrık) kesme işaretleri veya tırnak işaretleri içerebilir. Bunların kodlanması veya kesme işareti ya da tırnak işaretlerine dönüştürülmesi gerekir. Aksi takdirde, dosya yayımlandığında şu karakterleri görebilirsiniz: It’s

Bu noktalama işaretlerinin “akıllı” olanları için kodlamalar aşağıdaki gibidir:

• Sol (açma) tırnak işareti: “
• Sağ (kapatma) tırnak işareti: ”
• Sağ (kapatma) tekli tırnak işareti veya kesme işareti: ’
• Sağ (açma) tekli tırnak işareti (nadiren kullanılır): ‘

İpucu

Markdown dosyalarınızda "akıllı" karakterlerden kaçınmak için Learn Authoring Pack'in akıllı tırnak değiştirme özelliğine güvenin. Daha fazla bilgi için bkz. akıllı tırnak değiştirme.

Alıntı Blokları

Blok alıntılar, > karakteri kullanılarak oluşturulur:

> This is a blockquote. It is usually rendered indented and with a different background color.

Yukarıdaki örnek, şu şekilde işlenir:

Bu bir blok alıntısı. Genellikle girintili ve farklı bir arka plan rengiyle işlenir.

Kalın ve italik metin

Metni kalın olarak biçimlendirmek için iki yıldız işareti içine alın:

This text is **bold**.

Metni italik olarak biçimlendirmek için, metni tek bir yıldız işareti içine alın:

This text is *italic*.

Metni hem kalın hem de italik olarak biçimlendirmek için üç yıldız işareti içine alın:

This text is both ***bold and italic***.

Kalın ve italik metinlerin ne zaman kullanılacağına ilişkin yönergeler için bkz. metin biçimlendirme yönergeleri.

Kod parçacıkları

Learn Markdown, kod parçacıklarının hem cümle içinde satır içi hem de cümleler arasında ayrı bir "çitle çevrili" blok olarak yerleştirilmesini destekler. Daha fazla bilgi için bkz. Belgelere kod ekleme.

Sütunlar

Markdown uzantısı sütunları , yazarlara yalnızca gerçek tablo verileri için uygun olan temel Markdown tablolarından daha esnek ve güçlü sütun tabanlı içerik düzenleri ekleme olanağı sağlar. En fazla dört sütun ekleyebilir ve isteğe bağlı span özniteliğini kullanarak iki veya daha fazla sütunu birleştirebilirsiniz.

Sütun uzantısı çalışmaya devam etse de, özel düzenler oluşturmak için artık bunu önermeyiz. Birçok özel sütun düzeninin erişilebilirlik sorunları olduğunu veya stil yönergelerini ihlal ettiğini tespit ettik. Özel düzenler oluşturmayın. Standart Microsoft Learn özelliklerini kullanın.

Sütunların söz dizimi aşağıdaki gibidir:

:::row:::
   :::column span="":::
      Content...
   :::column-end:::
   :::column span="":::
      More content...
   :::column-end:::
:::row-end:::

Sütunlar yalnızca resimler de dahil olmak üzere temel Markdown içermelidir. Başlıklar, tablolar, sekmeler ve diğer karmaşık yapılar dahil edilmemelidir. Satırda sütunun dışında içerik olamaz.

Örneğin, aşağıdaki Markdown iki sütun genişliğine yayılan bir sütun ve bir standart (hayır span) sütun oluşturur:

:::row:::
   :::column span="2":::
      **This is a 2-span column with lots of text.**

      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec vestibulum mollis nunc
      ornare commodo. Nullam ac metus imperdiet, rutrum justo vel, vulputate leo. Donec
      rutrum non eros eget consectetur.
   :::column-end:::
   :::column span="":::
      **This is a single-span column with an image in it.**

      ![Doc.U.Ment](media/markdown-reference/document.png)
   :::column-end:::
:::row-end:::

Bu, şu şekilde işlenir:

Bu, çok fazla metin içeren 2 span'lık bir sütundur.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec vestibulum mollis nunc ornare commodo. Nullam ac metus imperdiet, rutrum justo vel, vulputate leo. Donec rutrum non eros eget consectetur.

Bu, içinde görüntü bulunan tek aralıklı bir sütundur.

Yorumlar

Makalenizin bölümlerini açıklama satırına çıkarmanız gerekiyorsa Microsoft Learn HTML açıklamalarını destekler:

<!--- Here's my comment --->

Uyarı

HTML açıklamalarına özel veya hassas bilgiler koymayın. Microsoft Learn, HTML açıklamalarını genel kullanıma açık yayımlanan HTML'ye taşır. HTML açıklamaları okuyucunun gözüne görünmese de, altındaki HTML'de gösterilir.

Bölüm başlıkları

Microsoft Learn altı markdown başlığı düzeyini destekler:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)

• Son # ile bölüm başlığı metni arasında bir boşluk olmalıdır.
• Her Markdown dosyasının bir ve yalnızca bir H1 başlığı olmalıdır.
• H1 başlığı, YML meta veri bloğundan sonra dosyadaki ilk içerik olmalıdır.
• H2 başlıkları, yayımlanan dosyanın sağ gezinti menüsünde otomatik olarak görüntülenir. Alt düzey başlıklar görünmez, bu nedenle okuyucuların içeriğinizde gezinmesine yardımcı olmak için H2'leri stratejik olarak kullanın.
• gibi <h1>HTML başlıkları önerilmez ve bazı durumlarda derleme uyarılarına neden olur.
• Yer işareti bağlantıları aracılığıyla bir dosyadaki tek tek başlıklara bağlanabilirsiniz.

HTML

Markdown satır içi HTML'yi desteklese de, Microsoft Learn'de yayımlamak için HTML önerilmez ve sınırlı bir değer listesi dışında derleme hatalarına veya uyarılarına neden olur.

Görüntüler

Görüntüler için varsayılan olarak aşağıdaki dosya türleri desteklenir:

• .jpg
• .png

.gif gibi diğer görüntü türlerini desteklemek için bunları docfx.json dosyasına kaynak olarak eklemeniz gerekir:

"resource": [
  {
    "files" : [
      "**/*.png",
      "**/*.jpg,
      "**/*.gif"
    ],

Standart kavramsal görüntüler (varsayılan Markdown)

Resim eklemek için temel Markdown söz dizimi şu şekildedir:

![<alt text>](<folderPath>)

Example:
![alt text for image](../images/Introduction.png)

<alt text>, görüntünün kısa bir açıklamasını ve <folder path>, görüntünün göreli yolunu ifade eder. Alternatif metin, görme engellilere yönelik ekran okuyucular için gereklidir. Görüntünün işlenebildiği bir site hatası olduğunda da kullanışlıdır.

Alternatif metindeki alt çizgiler, ön eklerine ters eğik çizgi ()\_ eklenerek kaçılmadıkça düzgün işlenmez. Ancak, dosya adlarını alternatif metin olarak kullanmak üzere kopyalamayın. Örneğin, bunun yerine:

![ADextension_2FA_Configure_Step4](./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG)

Şunu yazın:

![Active Directory extension for two-factor authentication, step 4: Configure](./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG)

Standart kavramsal görüntüler (Learn Markdown)

Microsoft Learn'de özel :::image::: uzantı standart görüntüleri, karmaşık görüntüleri ve simgeleri destekler.

Standart görüntüler için eski Markdown söz dizimi çalışmaya devam eder, ancak üst konu başlığından farklı bir yerelleştirme kapsamı belirtme gibi daha güçlü işlevleri desteklediğinden yeni uzantı önerilir. Yerel görüntü belirtmek yerine paylaşılan görüntü galerisinden seçim yapma gibi diğer gelişmiş işlevler gelecekte kullanılabilir olacaktır. Yeni söz dizimi aşağıdaki gibidir:

:::image type="content" source="<folderPath>" alt-text="<alt text>":::

(varsayılan) ise type="content" ve alt-text değerlerinin her ikisi source de gereklidir.

Uzun açıklamalı karmaşık görüntüler

Bu uzantıyı, ekran okuyucular tarafından okunan ancak yayımlanan sayfada görsel olarak işlenmemiş uzun açıklamalı bir resim eklemek için de kullanabilirsiniz. Uzun açıklamalar, grafikler gibi karmaşık görüntüler için erişilebilirlik gereksinimidir. Söz dizimi aşağıdaki gibidir:

:::image type="complex" source="<folderPath>" alt-text="<alt text>":::
   <long description here>
:::image-end:::

, source, , alt-textuzun bir açıklama ve :::image-end::: etiketi gerekliysetype="complex".

Değişiklikleriniz önizleme aşamasındayken veya yayımlandığında, resme sağ tıklayıp İncele'yi seçerek (diğer tarayıcılar benzer özelliklere sahip olsa da Microsoft Edge tarayıcısını kullanırken) uzun açıklamanın mevcut olup olmadığını denetleyebilirsiniz. Bu eylem sizi HTML kodundaki görüntü kaynağına getirir ve bunun altında görsel olarak gizli bir sınıf bulursunuz. Bu sınıftaki açılan listeyi genişletirseniz uzun açıklamanızı bulabilirsiniz:

Otomatik kenarlıklar

Uzantı, :::image::: görüntünüzün çevresine border otomatik olarak 1 piksel gri kenarlık ekleyen özelliğini de destekler. border özelliği ve complex görüntüleri için content varsayılan olarak kullanılırtrue, bu nedenle özelliği değerine açıkça eklemediğiniz sürece kenarlığı falseotomatik olarak alırsınız. border özelliği, görüntüler için icon varsayılan olarak kullanılırfalse.

border özelliği, kenarlık eklemenin önerilen yoludur. Kendi kenarlıklarınızı el ile oluşturmayın.

loc-scope belirtme

Bazen görüntünün yerelleştirme kapsamı, görüntüyü içeren makale veya modülden farklıdır. Bu, kötü bir genel deneyime neden olabilir: Örneğin, bir ürünün ekran görüntüsü yanlışlıkla ürünün kullanılamayabileceği bir dilde yerelleştirilmişse. Bunu önlemek için, ve complextürlerinin content görüntülerinde isteğe bağlı loc-scope özniteliği belirtebilirsiniz ve ürünü içeren makaleden veya modülden farklı bir yerelleştirme kapsamına sahip olan bir ürünü gösteren ekran görüntüleri için gereklidir.

Simgeler

Görüntü uzantısı, dekoratif görüntüler olan ve alternatif metinleri olmaması gereken simgeleri destekler. Simgelerin söz dizimi şu şekildedir:

:::image type="icon" source="<folderPath>":::

source ise type="icon"belirtilmelidir ancak alt-text belirtilmemelidir.

border özelliği varsayılan false olarak simgeler içindir. Dekoratif görüntünüz standart görüntü kenarını gerektiriyorsa etiketine :::image::: açıkça ekleyinborder="true".

Dahil edilen Markdown dosyaları

Markdown dosyalarının birden çok makalede tekrarlanması gerektiğinde, ekleme dosyası kullanabilirsiniz. ekleme özelliği, Microsoft Learn'e başvuruyu derleme zamanında ekleme dosyasının içeriğiyle değiştirmesini sağlar. Eklemeleri aşağıdaki yollarla kullanabilirsiniz:

• Satır içi: Genel bir metin parçacığını cümle içinde satır içi olarak yeniden kullanın.
• Blok: Makalenin bir bölümündeki bütün bir Markdown dosyasını yeniden kullanın.

Satır içi veya blok ekleme dosyası bir Markdown (.md) dosyasıdır. Bu dosyalar, herhangi bir geçerli Markdown barındırabilir. Ekleme dosyaları genellikle deponun kökündeki ortak bir ekleme alt dizininde bulunur. Makale yayımlandığında, eklenen dosya makaleyle sorunsuz bir şekilde tümleşmiş olur.

Söz dizimlerini içerir

Blok ekleme kendi satırındadır:

[!INCLUDE [<title>](<filepath>)]

Satır içi ekleme bir satır içindedir:

Text before [!INCLUDE [<title>](<filepath>)] and after.

Burada <title> dosyanın adı ve <filepath> dosyanın göreli yoludur. INCLUDE büyük harfe yazılmalıdır ve öncesinde bir boşluk <title>olmalıdır.

Ekleme dosyalarına yönelik gereksinimler ve önemli konular şunlardır:

• Blok eklemeleri bir veya iki paragraf, paylaşılan bir yordam veya paylaşılan bir kısım gibi büyük içeriklerle kullanın. Bunları bir cümleden daha küçük bir şey için kullanmayın.
• Eklemeler, Microsoft Learn uzantılarını kullandıklarından makalenizin GitHub tarafından işlenmiş görünümünde işlenmez. Bunlar yalnızca yayın sonrasında oluşturulur.
• Bir ekleme dosyasındaki tüm metni, eklemeye başvuran makaledeki önceki veya sonraki metne bağlı olmayan tam cümleler veya tümcecikler halinde yazın. Bu kılavuzu yoksaymak, makalede çevrilemeyen bir dize oluşturur.
• Ekleme dosyalarını diğer ekleme dosyalarına eklemeyin.
• /Includes klasörleri derlemenin dışında tutulur. Bu nedenle, klasörlerde /includes depolanan ve eklenen dosyalara başvurulan görüntüler yayımlanan içerikte görüntülenmez. Görüntüleri klasörün dışındaki bir /media klasörde depolayın /includes .
• Normal makalelerde olduğu gibi, ekleme dosyaları arasında medya paylaşmayın. Her bir ekleme ve makale için benzersiz ada sahip ayrı dosyalar kullanın. Medya dosyasını, eklemeyle ilişkili medya klasöründe depolayın.
• Eklemeleri, bir makalenin tek içeriği olarak kullanmayın. Eklemelerin, makaledeki diğer içerikleri tamamlayıcı görevi vardır.

Girinti

Markdown'da, bir satırın ilk karakterinden önceki boşluklar, çizginin önceki satırlara göre hizalamasını belirler. Girintileme, birden çok iç içe yerleştirme düzeyini hiyerarşik veya ana hat biçiminde işlemek için numaralandırılmış ve madde işaretli listeleri özellikle etkiler.

Metnin girintisini önceki paragrafla veya numaralandırılmış veya madde işaretli listedeki bir öğeyle hizalamak için boşluk kullanın.

Aşağıdaki iki örnek, girintili paragrafların diğer paragraflarla olan ilişkilerine göre nasıl işlendiğini gösterir.

1. This is a numbered list example (one space after the period before the letter T).
   This sentence is indented three spaces.
   This code block is indented three spaces.
   
- This is a bulleted list example (one space after the bullet before the letter T).
  This sentence is indented two spaces.
  > [!TIP]
  > This tip is indented two spaces.
  - This is a second-level bullet (indented two spaces, with one space after the bullet before the letter T).
    This sentence is indented four spaces.
    > This quote block is indented four spaces.

Yukarıdaki örnek şu şekilde işlenir:

1. Bu, numaralı bir liste örneğidir (T harfinden önceki dönemden sonra bir boşluk).

   Bu cümle üç boşluk girintilidir.

   This code block is indented three spaces.
   

• Bu madde işaretli liste örneğidir (T harfinden önceki madde işaretinden sonra bir boşluk).

  Bu cümle iki boşluk girintilidir.

  İpucu

  Bu ipucu iki boşluk girintili.

  • Bu ikinci düzey bir madde işaretidir (T harfinden önce madde işaretinden sonra bir boşlukla iki boşluk girintili).

    Bu cümlede dört boşluk girintili.

    Bu tırnak bloğunda dört boşluk girintili.

Bağlantılar

Bağlantıların söz dizimi hakkında bilgi için bkz. Belgelerde bağlantıları kullanma.

Listeler (Numaralandırılmış, Madde İşaretli, Denetim Listesi)

Numaralı liste

Numaralandırılmış liste oluşturmak için 1'lerin tümünü kullanabilirsiniz. Sayılar, yayımlandıklarında sıralı liste olarak artan düzende işlenir. Kaynak okunabilirliğini artırmak için listelerinizi el ile artırabilirsiniz.

İç içe listeler de dahil olmak üzere listelerde harf kullanmayın. Microsoft Learn'de yayımlandığında doğru işlenmez. Sayıların kullanıldığı iç içe geçmiş listeler, yayımlandığında küçük harfli listeler olarak işlenir. Örnek:

1. This is
1. a parent numbered list
   1. and this is
   1. a nested numbered list
1. (fin)

Bu, şu şekilde işlenir:

1. This is
2. a parent numbered list
   1. and this is
   2. a nested numbered list
3. (fin)

Madde işaretli liste

Madde işaretli liste oluşturmak için, her satırın başında bir boşluk kullanın - veya * ardından:

- This is
- a parent bulleted list
  - and this is
  - a nested bulleted list
- All done!

Bu, şu şekilde işlenir:

• This is
• a parent bulleted list
  • and this is
  • a nested bulleted list
• All done!

Veya kullandığınız söz dizimi -*makalenin içinde tutarlı bir şekilde kullanır.

Denetim Listesi

Denetim listeleri, Özel Markdown uzantısı aracılığıyla Microsoft Learn'de kullanılabilir:

> [!div class="checklist"]
> * List item 1
> * List item 2
> * List item 3

Bu örnek, Microsoft Learn'de şu şekilde işlenir:

• Liste öğesi 1
• List item 2
• Liste öğesi 3

Denetim listelerini bir makalenin başında veya sonunda, “Öğrenecekleriniz” veya “Öğrendikleriniz” içeriklerini özetlemek için kullanın. Makaleniz içerisinde denetim listelerini rastgele kullanmayın.

Sonraki adım eylemi

Microsoft Learn sayfalarına bir sonraki adım eylem düğmesi eklemek için özel bir uzantı kullanabilirsiniz.

Söz dizimi şu şekildedir:

> [!div class="nextstepaction"]
> [button text](link to topic)

Örnek:

> [!div class="nextstepaction"]
> [Learn about adding code to articles](code-in-docs.md)

Bu, şu şekilde işlenir:

Makalelere kod ekleme hakkında bilgi edinin

Bir sonraki adım eyleminde desteklenen tüm bağlantıları kullanabilirsiniz, buna farklı bir Web sayfasına ait Markdown bağlantısı da dahildir. Çoğu durumda, bir sonraki eylem bağlantısı aynı docset'teki başka bir dosyaya göreli bağlantı olur.

Yerelleştirilmemiş dizeler

Yerelleştirme işleminin yoksayılmasını istediğiniz içerik dizelerini tanımlamak için özel no-loc Markdown uzantısını kullanabilirsiniz.

Çağrılan tüm dizeler büyük/küçük harfe duyarlı olacaktır; diğer bir ifadeyle, dizenin yerelleştirme için yoksayılması için tam olarak eşleşmesi gerekir.

Tek bir dizeyi yerelleştirilebilir değil olarak işaretlemek için şu sözdizimini kullanın:

:::no-loc text="String":::

Örneğin, aşağıda, yerelleştirme işlemi sırasında yalnızca tek örneği Document yoksayılır:

# Heading 1 of the Document

Markdown content within the :::no-loc text="Document":::.  The are multiple instances of Document, document, and documents.

Not

Özel karakterlerden kaçmak için kullanın \ :

Lorem :::no-loc text="Find a \"Quotation\""::: Ipsum.

Geçerli Markdown dosyasındaki bir dizenin tüm örneklerini yerelleştirilebilir değil olarak işaretlemek için YAML üst bilgisindeki meta verileri de kullanabilirsiniz:

author: cillroy
no-loc: [Global, Strings, to be, Ignored]

Not

Konumsuz meta veriler , docfx.json dosyasında genel meta veriler olarak desteklenmez. Yerelleştirme işlem hattı docfx.json dosyasını okumaz, bu nedenle her kaynak dosyaya no-loc meta verilerinin eklenmesi gerekir.

Aşağıdaki örnekte hem meta verilerde title hem de Markdown üst bilgisinde yerelleştirme işlemi sırasında sözcük Document yoksayılır.

Meta verilerde description ve Markdown ana içeriğinde sözcüğü document yerelleştirilir çünkü büyük Dharfle başlamaz.

---
title: Title of the Document
author: author-name
description: Description for the document
no-loc: [Title, Document]
---
# Heading 1 of the Document

Markdown content within the document.

Seçiciler

Seçiciler, kullanıcının aynı makalenin birden çok türü arasında geçiş yapmasına olanak sağlayan kullanıcı arabirimi öğeleridir. Bunlar, teknolojiler veya platformlar arasındaki uygulama farklılıklarını gidermek için bazı docset'lerde kullanılır. Seçiciler genellikle mobil platform içeriğimiz için geliştiriciler için geçerlidir.

Seçiciyi kullanan her makale dosyasına aynı seçici Markdown gittiği için, makaleniz için seçiciyi bir ekleme dosyasına yerleştirmenizi öneririz. Daha sonra, aynı seçiciyi kullanan tüm makale dosyalarınızda bu ekleme dosyasına başvurabilirsiniz.

İki tür seçici vardır: tek seçici ve çoklu seçici.

Tek seçici

> [!div class="op_single_selector"]
> - [Universal Windows](../articles/notification-hubs-windows-store-dotnet-get-started/)
> - [Windows Phone](../articles/notification-hubs-windows-phone-get-started/)
> - [iOS](../articles/notification-hubs-ios-get-started/)
> - [Android](../articles/notification-hubs-android-get-started/)
> - [Kindle](../articles/notification-hubs-kindle-get-started/)
> - [Baidu](../articles/notification-hubs-baidu-get-started/)
> - [Xamarin.iOS](../articles/partner-xamarin-notification-hubs-ios-get-started/)
> - [Xamarin.Android](../articles/partner-xamarin-notification-hubs-android-get-started/)

... şu şekilde işlenir:

• Evrensel Windows
• Windows Phone
• iOS
• Android
• Kindle
• Baidu
• Xamarin.iOS
• Xamarin.Android

Çoklu seçici

> [!div class="op_multi_selector" title1="Platform" title2="Backend"]
> - [(iOS | .NET)](./mobile-services-dotnet-backend-ios-get-started-push.md)
> - [(iOS | JavaScript)](./mobile-services-javascript-backend-ios-get-started-push.md)
> - [(Windows universal C# | .NET)](./mobile-services-dotnet-backend-windows-universal-dotnet-get-started-push.md)
> - [(Windows universal C# | Javascript)](./mobile-services-javascript-backend-windows-universal-dotnet-get-started-push.md)
> - [(Windows Phone | .NET)](./mobile-services-dotnet-backend-windows-phone-get-started-push.md)
> - [(Windows Phone | Javascript)](./mobile-services-javascript-backend-windows-phone-get-started-push.md)
> - [(Android | .NET)](./mobile-services-dotnet-backend-android-get-started-push.md)
> - [(Android | Javascript)](./mobile-services-javascript-backend-android-get-started-push.md)
> - [(Xamarin iOS | Javascript)](./partner-xamarin-mobile-services-ios-get-started-push.md)
> - [(Xamarin Android | Javascript)](./partner-xamarin-mobile-services-android-get-started-push.md)

... şu şekilde işlenir:

• (iOS | .NET)
• (iOS | JavaScript)
• (Windows universal C# | .NET)
• (Windows universal C# | Javascript)
• (Windows Phone | .NET)
• (Windows Phone | Javascript)
• (Android | .NET)
• (Android | Javascript)
• (Xamarin iOS | Javascript)
• (Xamarin Android | Javascript)

Alt simge ve üst simge

Alt simgeyi veya üst simgeyi yalnızca matematiksel formüller hakkında yazarken olduğu gibi teknik doğruluk için gerekli olduğunda kullanmanız gerekir. Bunları dipnotlar gibi standart olmayan stiller için kullanmayın.

Hem alt simge hem de üst simge için HTML kullanın:

Hello <sub>This is subscript!</sub>

Bu, şu şekilde işlenir:

Merhaba _{Bu alt simge!}

Goodbye <sup>This is superscript!</sup>

Bu, şu şekilde işlenir:

Güle güle ^{Bu üst simge!}

Tables

Markdown’da bir tablo oluşturmanın en kolay yolu, kanallar ve çizgiler kullanmaktır. Üst bilgisi olan standart bir tablo oluşturmak için ilk satırın altına kısa çizgilerden oluşan bir satır ekleyin:

|This is   |a simple   |table header|
|----------|-----------|------------|
|table     |data       |here        |
|it doesn't|actually   |have to line up nicely!|

Bu, şu şekilde işlenir:

This is	a simple	table header
tablo	veriler	buraya
it doesn't	actually	have to line up nicely!

İki nokta üst üste kullanarak sütunları hizalayabilirsiniz:

| Fun                  | With                 | Tables          |
| :------------------- | -------------------: |:---------------:|
| left-aligned column  | right-aligned column | centered column |
| $100                 | $100                 | $100            |
| $10                  | $10                  | $10             |
| $1                   | $1                   | $1              |

Şu şekilde işlenir:

Tablolar	With	Tables
left-aligned column	right-aligned column	centered column
100 ABD Doları	100 ABD Doları	100 ABD Doları
10$	10$	10$
$1	$1	$1

İpucu

VS Code için Learn Yazma Uzantısı, temel Markdown tabloları eklemeyi kolaylaştırır!

Çevrimiçi tablo oluşturucu da kullanabilirsiniz.

Herhangi bir tablo hücresindeki sözcüklerin içindeki satır sonları

Markdown tablosundaki uzun sözcükler, tablonun sağ gezintiye genişletilmesine ve okunamaz hale gelmesine neden olabilir. İşlemenin gerektiğinde sözcüklerin içine otomatik olarak satır sonları eklemesine izin vererek bunu çözebilirsiniz. Yalnızca tabloyu [!div class="mx-tdBreakAll"] özel sınıfıyla sarmalayın.

Sınıf adı mx-tdBreakAll olan bir div tarafından sarmalanacak üç satırlı bir tablonun Markdown örneği aşağıdadır.

> [!div class="mx-tdBreakAll"]
> |Name|Syntax|Mandatory for silent installation?|Description|
> |-------------|----------|---------|---------|
> |Quiet|/quiet|Yes|Runs the installer, displaying no UI and no prompts.|
> |NoRestart|/norestart|No|Suppresses any attempts to restart. By default, the UI will prompt before restart.|
> |Help|/help|No|Provides help and quick reference. Displays the correct use of the setup command, including a list of all options and behaviors.|

Şöyle işlenir:

Name	Syntax	Sessiz yükleme için zorunlu mu?	Description
Quiet	istemci bilgisayarlara	Yes	Runs the installer, displaying no UI and no prompts.
NoRestart	/norestart	No	Yeniden başlatma girişimlerini engeller. Varsayılan olarak, kullanıcı arabirimi yeniden başlatmadan önce sizden onay ister.
Help	/help	No	Yardım ve hızlı başvuru sağlar. Displays the correct use of the setup command, including a list of all options and behaviors.

İkinci sütun tablo hücrelerindeki sözcüklerin içindeki satır sonları

Satır sonlarının, bir tablonun yalnızca ikinci sütunundaki sözcüklerin içine otomatik olarak eklenmesini isteyebilirsiniz. Sonları ikinci sütunla sınırlamak için, daha önce gösterildiği gibi sarmalayıcı söz dizimini div kullanarak sınıfını mx-tdCol2BreakAll uygulayın.

Tablolar arasındaki tutarsız sütun genişlikleri

Makalelerinizdeki tabloların sütun genişliklerinin tek veya tutarsız göründüğünü fark edebilirsiniz. Bu davranış, hücrelerdeki metnin uzunluğu tablonun düzenini belirlediğinden oluşur. Ne yazık ki tabloların nasıl işlenme şeklini denetlemenin bir yolu yoktur. Bu, Markdown'ın bir sınırlamasıdır. Tablo sütunlarının genişliğinin tutarlı olması daha iyi görünse de, bunun da bazı dezavantajları olacaktır:

• HTML kodunun Markdown ile birlikte kullanılması konuları daha karmaşık hale getirir ve topluluk katkılarını önerilmez.
• Belirli bir ekran boyutu için iyi görünmesini istediğiniz bir tablo, yanıt veren işlemeyi ön plana çıkarırken farklı ekran boyutlarında okunamaz görünebilir.

Veri matrisi tabloları

Veri matrisi tablosunda hem üst bilgi hem de ağırlıklı ilk sütun bulunur ve sol üst kısımda boş bir hücreyle matris oluşturulur. Microsoft Learn'de veri matrisi tabloları için özel Markdown vardır:

|                  |Header 1 |Header 2|
|------------------|---------|--------|
|**First column A**|Cell 1A  |Cell 2A |
|**First column B**|Cell 1B  |Cell 2B |

Örnek şu şekilde işlenir:

	Üst Bilgi 1	Üst Bilgi 2
İlk sütun A	Hücre 1A	Hücre 2A
İlk sütun B	Hücre 1B	Hücre 2B

İlk sütundaki her girdi kalın (**bold**) olarak stillendirilmelidir; aksi takdirde tablolara ekran okuyucular için erişilemez veya Microsoft Learn için geçerli olmaz.

İpucu

VS Code için Learn Yazma Paketi, normal markdown tablosunu veri matris tablosuna dönüştüren bir işlev içerir. Tabloyu seçin, sağ tıklayın ve Veri matrisi tablosuna dönüştür'ü seçin.

HTML Tabloları

Microsoft Learn için HTML tabloları önerilmez. Kaynakta insanlar tarafından okunamaz. Bu markdown'ın temel prensibidir.