Bagikan melalui

Referensi Markdown Tanya Jawab Microsoft

Microsoft Q&A mendukung pengalaman editor web yang kaya, sehingga Anda tidak perlu khawatir tentang mengedit konten di Markdown. Dalam kasus yang Anda lakukan, berikut adalah referensi untuk menulis Markdown untuk Tanya Jawab.

Markdown adalah bahasa markup ringan dengan sintaks pemformatan teks biasa. learn.microsoft.com (Learn) mendukung Markdown yang mematuhi CommonMark yang diurai melalui mesin penguraian Markdig . Pelajari dan Tanya Jawab juga mendukung ekstensi Markdown kustom yang menyediakan konten yang lebih kaya di situs. Tanya Jawab menggunakan subset ekstensi yang didukung dalam dokumentasi Learn. Artikel ini menyediakan referensi alfabet.

Anda dapat melihat informasi selengkapnya tentang artikel referensi Pelajari Markdown.

Cuplikan kode

Kutipan blok

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

Contoh sebelumnya merender sebagai berikut:

Ini adalah blockquote. Biasanya dirender inden dan dengan warna latar belakang yang berbeda.

Blok kode

Anda dapat menambahkan bahasa kode ke blok kode untuk penyajian yang lebih kaya.

```csharp
    public static void Log(string message)
            {
                _logger.LogInformation(message);
            }
    ```

Contoh sebelumnya merender sebagai berikut:

    public static void Log(string message)
            {
                _logger.LogInformation(message);
            }

Emoji

Tanya Jawab akan mengonversi kode pendek emoji ke karakter Unicode masing-masing:

This is a test with a :).

Contoh sebelumnya merender sebagai berikut:

Ini adalah tes dengan 😃.

Pemformatan

Untuk memformat teks sebagai tebal, sertakan dalam dua tanda bintang:

This text is **bold**.

Untuk memformat teks sebagai miring, sertakan teks dalam satu tanda bintang:

This text is *italic*.

Untuk memformat teks sebagai tebal dan miring, sertakan dalam tiga tanda bintang:

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

Untuk memformat teks sebagai coretan, sertakan dengan dua di sekitarnya dengan dua tilde:

This text is ~~strikeout~~.

Header

Tanya Jawab mendukung enam tingkat judul Markdown:

# This is a first level heading (H1)

## This is a second level heading (H2)

...

###### This is a sixth level heading (H6)
  • Harus ada spasi antara teks terakhir # dan judul.
  • Setiap pertanyaan, jawaban, atau komentar harus memiliki satu dan hanya satu judul H1.

HTML

Jika Anda memasukkan konten HTML, maka konten tidak akan dirender. Sebaliknya, ini akan ditampilkan sebagai teks biasa.

Gambar

Ekstensi kustom :::image::: Learn mendukung gambar standar, gambar kompleks, dan ikon.

:::image source="<folderOrURLPath>" alt-text="<alt text>":::

Di mana <alt text> adalah deskripsi singkat tentang gambar dan <folderOrURLPath> merupakan jalur relatif ke gambar atau URL-nya. Teks alternatif diperlukan untuk pembaca layar untuk gangguan visual. Ini juga berguna jika ada bug situs di mana gambar tidak dapat dirender. Jangan salin nama file untuk digunakan sebagai teks alt. Misalnya, daripada seperti ini:

:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="ADextension_2FA_Configure_Step4":::

Tulis ini:

:::image source="./media/bogusfilename/ADextension_2FA_Configure_Step4.PNG" alt-text="Active Directory extension for two-factor authentication, step 4: Configure":::

Tautan mudah ditambahkan di Tanya Jawab. Tautan mengarahkan pengguna ke konten halaman lain di Tanya Jawab atau sumber tepercaya lainnya.

[Link text](<FullURL>).

[Microsoft Q&A products page](/answers/products).`

Teks tautan

Kata-kata yang Anda sertakan dalam teks tautan harus ramah. Dengan kata lain, kata tersebut harus berupa kata-kata bahasa Inggris normal atau judul halaman yang Anda tautkan.

Jangan gunakan "pilih di sini." untuk "Teks tautan". Ini buruk untuk pengoptimalan mesin pencari dan tidak menggambarkan target secara memadai.

Penting

Semua tautan harus aman (https vs http) setiap kali target mendukungnya (yang harus sebagian besar).

Contoh:

For more information, see the [Microsoft Q&A products page](/answers/products).

Contoh di atas merender sebagai:

Untuk informasi selengkapnya, lihat halaman Produk Tanya Jawab Microsoft.

Tautan akan diformat otomatis untuk string apa pun yang dimulai oleh: https://, , https://, ftp://, mailto:, tel:atau www. (diselesaikan ke https://www.)

Daftar (Bernomor, Berpoin)

Daftar bernomor

Untuk membuat daftar bernomor, Anda bisa menggunakan semua 1. Angka dirender dalam urutan naik sebagai daftar berurutan saat diterbitkan. Untuk peningkatan keterbacaan sumber, Anda dapat meningkatkan daftar Anda secara manual.

Jangan gunakan huruf dalam daftar, termasuk daftar berlapis. Mereka tidak dirender dengan benar saat diterbitkan. Daftar berlapis menggunakan angka akan dirender sebagai huruf kecil saat diterbitkan. Contohnya:

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

Ini dirender sebagai berikut:

  1. Ini adalah
  2. daftar bernomor induk
    1. dan ini adalah
    2. daftar bernomor berlapis
  3. (Sirin)

Daftar berpoin

Untuk membuat daftar berpoin, gunakan - atau * diikuti dengan spasi di awal setiap baris:

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

Ini dirender sebagai berikut:

  • Ini adalah
  • daftar berpoin induk
    • dan ini adalah
    • daftar berpoin berlapis
  • Semua selesai!

Sintaks apa pun yang Anda gunakan, - atau *, gunakan secara konsisten dalam konten Anda.

Tabel

Cara paling sederhana untuk membuat tabel di Markdown adalah dengan menggunakan pipa dan garis. Untuk membuat tabel standar dengan header, ikuti baris pertama dengan garis putus-putus:

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

Ini dirender sebagai berikut:

Ini adalah sederhana header tabel
tabel data di sini
tidak sebenarnya harus berbaris dengan baik!
  • Last updated on