Microsoft Soru-Cevap Markdown başvurusu
Microsoft Soru-Cevap zengin web düzenleyicisi deneyimini desteklediğinden Markdown'da içeriği düzenleme konusunda endişelenmenize gerek kalmaz. Böyle bir durumda, soru-cevap için Markdown yazmaya yönelik bir başvuru aşağıdadır.
Markdown, düz metin biçimli söz dizimine sahip hafif bir işaretleme dilidir.
learn.microsoft.com
(Learn) Markdig ayrıştırma altyapısı aracılığıyla ayrıştırılan CommonMark uyumlu Markdown'ı destekler. Learn ve Soru-Cevap, sitede daha zengin içerik sağlayan özel Markdown uzantılarını da destekler. Soru-Cevap, Learn belgelerinde desteklenen uzantıların bir alt kümesini kullanır. Bu makale alfabetik bir başvuru sağlar.
Daha fazla bilgiyi Learn Markdown başvuru makalesinde görebilirsiniz.
Kod parçacıkları
Alıntıyı engelle
> This example is a blockquote. It's usually rendered indented and with a different background color.
Yukarıdaki örnek, şu şekilde işlenir:
Bu bir blok alıntıdır. Genellikle girintili ve farklı bir arka plan rengiyle işlenir.
Kod blokları
Daha zengin işleme için kod dilini bir kod bloğuna ekleyebilirsiniz.
```csharp
public static void Log(string message)
{
_logger.LogInformation(message);
}
```
Yukarıdaki örnek, şu şekilde işlenir:
public static void Log(string message)
{
_logger.LogInformation(message);
}
Emojiler
Soru-Cevap, emoji kısa kodunu ilgili Unicode karakterlerine dönüştürür:
This is a test with a :).
Yukarıdaki örnek, şu şekilde işlenir:
Bu, ile yapılan bir 😃testtir.
Biçimlendirme
Bir metni kalın olarak biçimlendirmek için iki yıldız işareti arasına alın:
This text is **bold**.
Bir metni italik olarak biçimlendirmek için bir yıldız işareti arasına alın:
This text is *italic*.
Bir metni kalın ve italik olarak biçimlendirmek için üç yıldız işareti arasına alın:
This text is both ***bold and italic***.
Metni üstü çizili olarak biçimlendirmek için, iki tilde çevreleyerek içine alın:
This text is ~~strikeout~~.
Üst Bilgiler
Soru-Cevap 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 soru, yanıt veya açıklamanın bir ve yalnızca bir H1 başlığı olmalıdır.
HTML
HTML içeriği girerseniz içerik işlenmez. Bunun yerine düz metin olarak gösterilir.
Görüntüler
Learn özel :::image:::
uzantısı standart görüntüleri, karmaşık görüntüleri ve simgeleri destekler.
:::image source="<folderOrURLPath>" alt-text="<alt text>":::
Burada <alt text>
görüntünün kısa bir açıklaması ve <folderOrURLPath>
görüntünün veya URL'sinin göreli yoludur. Alternatif metin, görme engellilere yönelik ekran okuyucular için gereklidir. Ayrıca görüntünün işlenememesine yol açan bir site hatası durumunda işe yarar. Alternatif metin olarak kullanmak üzere dosya adlarını kopyalamayın. Örneğin, şunun yerine:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::
Şunu yazın:
:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::
Bağlantılar
Soru-Cevap'a kolayca bağlantı ekleyebilirsiniz. Bağlantılar, kullanıcıları Soru-Cevap'ta veya başka bir güvenilir kaynakta başka bir sayfayı içeriğe yönlendirer.
[Link text](<FullURL>).
[Microsoft Q&A products page](/answers/products).`
Bağlantı metni
Bağlantı metnine eklediğiniz sözcükler kolay olmalıdır. Diğer bir deyişle, bunlar normal Türkçe kelimeler veya bağlantı kurduğunuz sayfanın başlığı olmalıdır.
"Bağlantı metni" için "burayı seçin" kullanmayın. Bu, arama alt yapısı iyileştirmesi açısından kötüdür ve hedefi yeterli derecede açıklamaz.
Önemli
Hedef desteklediğinde (büyük bir bölümü destekler), tüm bağlantılar güvenli olmalıdır (https
veya http
).
Örnek:
For more information, see the [Microsoft Q&A products page](/answers/products).
Yukarıdaki örnek şu şekilde işlenir:
Daha fazla bilgi için Microsoft Soru-Cevap ürünleri sayfasına bakın.
Otomatik bağlantılar
Bağlantılar, şununla başlayan tüm dizeler için otomatik biçimlendirilir: https://
, https://
ftp://
, , mailto:
, , tel:
veya www.
(olarak çözümlenirhttps://www
.)
Listeler (Numaralandırılmış, Madde İşaretli)
Numaralı liste
Numaralı liste oluşturmak için sadece 1 rakamlarını kullanabilirsiniz. Belge yayımlandığında numaralar artan sırada düzenlenir. Daha fazla kaynak okunabilirliği için listelerinizi el ile artırabilirsiniz.
Listelerde (iç içe geçmiş listeler dahil) harf kullanmayın. 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. Örneğin:
1. This is
1. a parent numbered list
1. and this is
1. a nested numbered list
1. (fin)
Bu, şu şekilde işlenir:
- This is
- üst numaralandırılmış liste
- and this is
- a nested numbered list
- (fin)
Madde işaretli liste
Madde işaretli liste oluşturmak için her satırın başında -
veya *
ve ardından boşluk kullanın:
- This is
- a parent bulleted list
- and this is
- a nested bulleted list
- All done!
Bu, şu şekilde işlenir:
- This is
- üst madde işaretli liste
- and this is
- a nested bulleted list
- Hepsi bu kadar!
veya kullandığınız söz dizimi -
*
içeriğinizde tutarlı bir şekilde kullanılır.
Tablolar
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 |
---|---|---|
table | veriler | here |
it doesn't | actually | have to line up nicely! |