Pelajari referensi Markdown

Artikel ini menyediakan referensi alfabet untuk menulis Markdown untuk Microsoft Learn.

Markdown adalah bahasa markup ringan dengan sintaks pemformatan teks biasa. Platform Microsoft Learn mendukung Markdown yang mematuhi CommonMark yang diurai melalui mesin penguraian Markdig . Microsoft Learn juga mendukung ekstensi Markdown kustom yang menyediakan konten yang lebih kaya di situs Microsoft Learn.

Anda dapat menggunakan editor teks apa pun untuk menulis Markdown, tetapi sebaiknya Visual Studio Code dengan Learn Authoring Pack. Learn Authoring Pack menyediakan alat pengeditan dan fungsionalitas pratinjau yang memungkinkan Anda melihat seperti apa tampilan artikel Anda saat dirender di Microsoft Learn.

Pemberitahuan (Catatan, Tips, Penting, Perhatian, Peringatan)

Pemberitahuan adalah ekstensi Markdown untuk membuat tanda kutip blok yang dirender di Microsoft Learn dengan warna dan ikon yang menunjukkan signifikansi konten.

Hindari catatan, tips, dan kotak penting. Pembaca cenderung melewatinya. Lebih baik memasukkan info itu langsung ke dalam teks artikel.

Jika Anda perlu menggunakan pemberitahuan, batasi hingga satu atau dua per artikel. Beberapa catatan tidak boleh berdampingan dalam artikel.

Jenis pemberitahuan berikut ini didukung:

> [!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.

Pemberitahuan ini terlihat seperti ini di Microsoft Learn:

Catatan

Informasi yang harus diperhatikan pengguna meskipun melakukan skimming.

Tip

Informasi opsional untuk membantu pengguna menjadi lebih sukses.

Penting

Informasi penting yang diperlukan untuk keberhasilan pengguna.

Perhatian

Konsekuensi potensial negatif dari suatu tindakan.

Peringatan

Konsekuensi tertentu yang berbahaya dari suatu tindakan.

Kurung sudut

Jika Anda menggunakan kurung sudut dalam teks dalam file Anda (misalnya, untuk menunjukkan tempat penampung), Anda perlu mengodekan kurung sudut secara manual. Jika tidak, Markdown berpikir bahwa mereka dimaksudkan untuk menjadi tag HTML.

Misalnya, enkode <script name> sebagai <script name> atau \<script name>.

Kurung sudut tidak harus diloloskan dalam teks yang diformat sebagai kode sebaris atau di blok kode.

Tanda kutip dan apostrof

Jika Anda menyalin dari Word ke editor Markdown, teks mungkin berisi tanda kutip atau tanda kutip "cerdas". Ini perlu dikodekan atau diubah ke apostrof dasar atau tanda kutip. Jika tidak, Anda berakhir dengan hal-hal seperti ini ketika file diterbitkan: Itâ €™s

Berikut adalah pengodean untuk versi "cerdas" dari tanda baca ini:

• Tanda kutip kiri (pembuka): “
• Tanda kutip kanan (penutup): ”
• Tanda kutip atau apostrof tunggal kanan (menutup): ’
• Tanda kutip tunggal (pembuka) kiri (jarang digunakan): ‘

Tip

Untuk menghindari karakter "cerdas" dalam file Markdown Anda, bergantung pada fitur penggantian kutipan pintar Learn Authoring Pack. Untuk informasi selengkapnya, lihat penggantian kuotasi pintar.

Blockquotes

Blockquotes dibuat menggunakan > karakter :

> This is a blockquote. It is 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.

Teks tebal dan miring

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

This text is **bold**.

Untuk memformat teks sebagai miring, sertakan 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 panduan tentang kapan harus menggunakan teks tebal dan miring, lihat panduan pemformatan teks.

Cuplikan kode

Learn Markdown mendukung penempatan cuplikan kode baik sebaris dalam kalimat maupun sebagai blok "pagar" terpisah di antara kalimat. Untuk informasi selengkapnya, lihat Cara menambahkan kode ke dokumen.

Kolom

Ekstensi Markdown kolom memberi penulis kemampuan untuk menambahkan tata letak konten berbasis kolom yang lebih fleksibel dan kuat daripada tabel Markdown dasar, yang hanya cocok untuk data tabular benar. Anda dapat menambahkan hingga empat kolom, dan menggunakan atribut opsional span untuk menggabungkan dua kolom atau lebih.

Meskipun ekstensi kolom masih berfungsi, kami tidak lagi merekomendasikannya untuk membuat tata letak kustom. Kami telah menemukan bahwa banyak tata letak kolom kustom memiliki masalah aksesibilitas atau melanggar pedoman gaya. Jangan membuat tata letak kustom. Gunakan fitur Microsoft Learn standar.

Sintaks untuk kolom adalah sebagai berikut:

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

Kolom hanya boleh berisi Markdown dasar, termasuk gambar. Judul, tabel, tab, dan struktur kompleks lainnya tidak boleh disertakan. Baris tidak dapat memiliki konten apa pun di luar kolom.

Misalnya, Markdown berikut membuat satu kolom yang mencakup dua lebar kolom, dan satu kolom standar (tanpa span) :

:::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:::

Ini dirender sebagai berikut:

Ini adalah kolom rentang 2 dengan banyak teks.

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.

Ini adalah kolom rentang tunggal dengan gambar di dalamnya.

Komentar

Microsoft Learn mendukung komentar HTML jika Anda harus mengomentari bagian artikel Anda:

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

Peringatan

Jangan letakkan informasi privat atau sensitif dalam komentar HTML. Microsoft Learn membawa komentar HTML ke HTML yang diterbitkan yang berpusat pada publik. Sementara komentar HTML tidak terlihat oleh mata pembaca, komentar tersebut diekspos dalam HTML di bawahnya.

Heading

Microsoft Learn 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 file Markdown harus memiliki satu dan hanya satu judul H1.
• Judul H1 harus menjadi konten pertama dalam file setelah blok metadata YML.
• Judul H2 secara otomatis muncul di menu navigasi sebelah kanan file yang diterbitkan. Judul tingkat bawah tidak muncul, jadi gunakan H2s secara strategis untuk membantu pembaca menavigasi konten Anda.
• Judul HTML, seperti <h1>, tidak disarankan, dan dalam beberapa kasus akan menyebabkan peringatan build.
• Anda dapat menautkan ke judul individual dalam file melalui tautan bookmark.

HTML

Meskipun Markdown mendukung HTML sebaris, HTML tidak disarankan untuk diterbitkan ke Microsoft Learn, dan kecuali untuk daftar nilai terbatas akan menyebabkan kesalahan atau peringatan build.

Gambar

Jenis file berikut didukung secara default untuk gambar:

• .jpg
• .png

Untuk mendukung jenis gambar lainnya, seperti .gif, Anda harus menambahkannya sebagai sumber daya di docfx.json:

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

Gambar konseptual standar (Markdown default)

Sintaks Markdown dasar untuk menyematkan gambar adalah:

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

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

Di mana <alt text> adalah deskripsi singkat dari gambar dan <folder path> merupakan jalur relatif ke gambar. Teks alternatif diperlukan untuk pembaca layar untuk gangguan penglihatan. Ini juga berguna jika ada bug situs di mana gambar tidak dapat dirender.

Garis bawah dalam teks alt tidak dirender dengan benar kecuali Anda melepaskannya dengan mengawalinya dengan garis miring terbalik (\_). Namun, jangan salin nama file untuk digunakan sebagai teks alt. Misalnya, daripada seperti ini:

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

Tulis ini:

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

Gambar konseptual standar (Pelajari Markdown)

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

Untuk gambar standar, sintaks Markdown yang lebih lama akan tetap berfungsi, tetapi ekstensi baru direkomendasikan karena mendukung fungsionalitas yang lebih kuat, seperti menentukan cakupan pelokalan yang berbeda dari topik induk. Fungsionalitas tingkat lanjut lainnya, seperti memilih dari galeri gambar bersama alih-alih menentukan gambar lokal, akan tersedia di masa mendatang. Sintaks baru adalah sebagai berikut:

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

Jika type="content" (default), baik source dan alt-text diperlukan.

Gambar kompleks dengan deskripsi panjang

Anda juga dapat menggunakan ekstensi ini untuk menambahkan gambar dengan deskripsi panjang yang dibaca oleh pembaca layar tetapi tidak dirender secara visual di halaman yang diterbitkan. Deskripsi panjang adalah persyaratan aksesibilitas untuk gambar yang kompleks, seperti grafik. Sintaksnya adalah sebagai berikut:

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

Jika type="complex", source, alt-text, deskripsi panjang, dan :::image-end::: tag semuanya diperlukan.

Saat perubahan Anda dalam pratinjau atau diterbitkan, Anda dapat memeriksa apakah deskripsi panjang ada dengan mengklik kanan gambar dan memilih Periksa (saat menggunakan browser Microsoft Edge, meskipun browser lain memiliki fitur serupa). Tindakan ini membawa Anda ke sumber gambar dalam kode HTML, di bawahnya Anda akan menemukan kelas yang tersembunyi secara visual . Perluas menu dropdown di kelas ini, dan Anda akan menemukan deskripsi panjang Anda:

Batas otomatis

Ekstensi ini :::image::: juga mendukung border properti , yang secara otomatis menambahkan batas abu-abu 1 piksel di sekitar gambar Anda. Properti border secara default untuk truecontent gambar dan complex , jadi Anda akan mendapatkan batas secara otomatis kecuali Anda secara eksplisit menambahkan properti dengan nilai false. Properti border secara default untuk falseicon gambar.

Properti border adalah cara yang disarankan untuk menambahkan batas. Jangan membuat batas Anda sendiri secara manual.

Menentukan cakupan loc

Terkadang cakupan pelokalan untuk gambar berbeda dari artikel atau modul yang berisinya. Ini dapat menyebabkan pengalaman global yang buruk: misalnya, jika cuplikan layar produk secara tidak sengaja dilokalkan ke dalam bahasa yang tidak tersedia produk. Untuk mencegah hal ini, Anda dapat menentukan atribut opsional loc-scope dalam gambar jenis content dan complex, dan diperlukan untuk cuplikan layar yang menampilkan produk dengan cakupan pelokalan yang berbeda dari artikel atau modul yang berisinya.

Ikon

Ekstensi gambar mendukung ikon, yang merupakan gambar dekoratif dan tidak boleh memiliki teks alt. Sintaks untuk ikon adalah:

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

Jika type="icon", source harus ditentukan tetapi alt-text tidak boleh.

Properti border secara default untuk false ikon. Jika gambar dekoratif Anda memerlukan batas gambar standar, tambahkan border="true" secara eksplisit ke :::image::: tag.

File Markdown yang disertakan

Jika file markdown perlu diulang di beberapa artikel, Anda dapat menggunakan file include. Fitur menyertakan menginstruksikan Microsoft Learn untuk mengganti referensi dengan konten file include pada waktu build. Anda dapat menggunakan menyertakan dengan cara berikut:

• Sebaris: Gunakan kembali cuplikan teks umum sebaris dengan dalam kalimat.
• Blokir: Gunakan kembali seluruh file Markdown sebagai blok, yang ditumpuk dalam bagian artikel.

File inline atau block include adalah file Markdown (.md). Ini dapat berisi Markdown yang valid. Sertakan file biasanya terletak di umum termasuk subdirektori, di akar repositori. Ketika artikel diterbitkan, file yang disertakan diintegrasikan dengan mulus ke dalamnya.

Menyertakan sintaks

Blokir termasuk pada barisnya sendiri:

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

Inline include berada dalam baris:

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

Di mana <title> adalah nama file dan <filepath> merupakan jalur relatif ke file. INCLUDE harus dijadikan huruf kapital dan harus ada ruang sebelum <title>.

Berikut adalah persyaratan dan pertimbangan untuk menyertakan file:

• Blok penggunaan mencakup untuk sejumlah besar konten--satu atau dua paragraf, prosedur bersama, atau bagian bersama. Jangan menggunakannya untuk sesuatu yang lebih kecil dari kalimat.
• Termasuk tidak akan dirender dalam tampilan artikel Anda yang dirender GitHub karena bergantung pada ekstensi Microsoft Learn. Mereka akan dirender hanya setelah publikasi.
• Tulis semua teks dalam file sertakan dalam kalimat atau frasa lengkap yang tidak bergantung pada teks sebelumnya atau berikut dalam artikel yang mereferensikan penyertaan. Mengabaikan panduan ini membuat string yang tidak dapat diterjemahkan dalam artikel.
• Jangan sematkan sertakan file dalam file lain termasuk.
• /Includes folder dikecualikan dari build. Oleh karena itu, gambar yang disimpan dalam /includes folder dan direferensikan dalam file yang disertakan tidak akan ditampilkan dalam konten yang diterbitkan. Simpan gambar dalam /media folder di luar /includes folder.
• Seperti artikel reguler, jangan bagikan media antara menyertakan file. Gunakan file terpisah dengan nama unik untuk setiap sertakan dan artikel. Simpan file media di folder media yang terkait dengan sertakan.
• Jangan gunakan sertakan sebagai satu-satunya konten artikel. Termasuk dimaksudkan untuk menjadi tambahan untuk konten di sisa artikel.

Indentasi

Di Markdown, spasi sebelum karakter pertama baris menentukan perataan garis relatif terhadap garis sebelumnya. Indentasi terutama memengaruhi daftar bernomor dan berpoin untuk merender beberapa tingkat bersarang dalam format hierarkis atau kerangka.

Untuk mengindentasi teks untuk meratakan dengan paragraf sebelumnya atau item dalam daftar bernomor atau berpoin, gunakan spasi.

Dua contoh berikut menunjukkan bagaimana paragraf yang diindentasi dirender berdasarkan hubungannya dengan paragraf lain.

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.

Contoh di atas merender sebagai:

1. Ini adalah contoh daftar bernomor (satu spasi setelah periode sebelum huruf T).

   Kalimat ini diinden tiga spasi.

   This code block is indented three spaces.
   

• Ini adalah contoh daftar berpoin (satu spasi setelah poin sebelum huruf T).

  Kalimat ini diindentasi dua spasi.

  Tip

  Tip ini diindentasi dua spasi.

  • Ini adalah poin tingkat kedua (mengindentasi dua spasi, dengan satu spasi setelah poin sebelum huruf T).

    Kalimat ini diindentasi empat spasi.

    Blok kutipan ini diindentasi empat spasi.

Tautan

Untuk informasi tentang sintaks untuk tautan, lihat Menggunakan tautan dalam dokumentasi.

Daftar (Bernomor, Berpoin, Daftar Periksa)

Daftar bernomor

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

Jangan gunakan huruf dalam daftar, termasuk daftar berlapis. Mereka tidak dirender dengan benar saat diterbitkan ke Microsoft Learn. 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. (Sirfin)

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 artikel.

Daftar periksa

Daftar periksa tersedia untuk digunakan di Microsoft Learn melalui ekstensi Markdown kustom:

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

Contoh ini dirender di Microsoft Learn seperti ini:

• Item daftar 1
• Item daftar 2
• Item daftar 3

Gunakan daftar periksa di awal atau akhir artikel untuk meringkas konten "Apa yang akan Anda pelajari" atau "Apa yang telah Anda pelajari". Jangan tambahkan daftar periksa acak di seluruh artikel Anda.

Tindakan langkah berikutnya

Anda dapat menggunakan ekstensi kustom untuk menambahkan tombol tindakan langkah berikutnya ke halaman Microsoft Learn.

Sintaksnya adalah sebagai berikut:

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

Contohnya:

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

Ini dirender sebagai berikut:

Pelajari tentang menambahkan kode ke artikel

Anda dapat menggunakan tautan yang didukung dalam tindakan langkah berikutnya, termasuk tautan Markdown ke halaman web lain. Dalam kebanyakan kasus, tautan tindakan berikutnya akan menjadi tautan relatif ke file lain dalam docset yang sama.

String yang tidak dilokalkan

Anda dapat menggunakan ekstensi Markdown kustom no-loc untuk mengidentifikasi string konten yang ingin diabaikan oleh proses pelokalan.

Semua string yang dipanggil akan peka huruf besar/kecil; artinya, string harus cocok persis untuk diabaikan untuk pelokalan.

Untuk menandai string individual sebagai tidak dapat dilokalkan, gunakan sintaks ini:

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

Misalnya, dalam hal berikut, hanya satu instans Document yang akan diabaikan selama proses pelokalan:

# Heading 1 of the Document

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

Catatan

Gunakan \ untuk meloloskan karakter khusus:

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

Anda juga dapat menggunakan metadata di header YAML untuk menandai semua instans string dalam file Markdown saat ini sebagai tidak dapat dilokalkan:

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

Catatan

Metadata no-loc tidak didukung sebagai metadata global dalam file docfx.json . Alur pelokalan tidak membaca file docfx.json , sehingga metadata no-loc harus ditambahkan ke dalam setiap file sumber individual.

Dalam contoh berikut, baik di metadata title maupun header Markdown kata Document akan diabaikan selama proses pelokalan.

Dalam metadata description dan konten utama Markdown kata document dilokalkan, karena tidak dimulai dengan modal D.

---
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.

Pemilih

Pemilih adalah elemen UI yang memungkinkan pengguna beralih di antara beberapa ragam artikel yang sama. Mereka digunakan dalam beberapa docset untuk mengatasi perbedaan implementasi di seluruh teknologi atau platform. Pemilih biasanya paling berlaku untuk konten platform seluler kami untuk pengembang.

Karena Markdown pemilih yang sama masuk ke setiap file artikel yang menggunakan pemilih, sebaiknya tempatkan pemilih untuk artikel Anda dalam file sertakan. Kemudian Anda dapat mereferensikan yang menyertakan file dalam semua file artikel Anda yang menggunakan pemilih yang sama.

Ada dua jenis pemilih: satu pemilih dan multi-pemilih.

Pemilih tunggal

> [!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/)

... akan dirender seperti ini:

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

Multi-pemilih

> [!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)

... akan dirender seperti ini:

• (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)

Subskrip dan superskrip

Anda hanya boleh menggunakan subskrip atau superskrip jika diperlukan untuk akurasi teknis, seperti saat menulis tentang rumus matematika. Jangan gunakan untuk gaya non-standar, seperti catatan kaki.

Untuk subskrip dan superskrip, gunakan HTML:

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

Ini dirender sebagai berikut:

Halo _{Ini adalah subskrip!}

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

Ini dirender sebagai berikut:

Selamat tinggal ^{Ini superskrip!}

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
itu tidak	Benar	harus berbaris dengan baik!

Anda bisa meratakan kolom dengan menggunakan titik dua:

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

Render sebagai berikut:

Menyenangkan	Dengan	Tabel
kolom rata kiri	kolom rata kanan	kolom tengah
$100	$100	$100
$10	$10	$10
$1	$1	$1

Tip

Learn Authoring Extension for VS Code memudahkan untuk menambahkan tabel Markdown dasar!

Anda juga dapat menggunakan generator tabel online.

Pemisah baris dalam kata di sel tabel mana pun

Kata-kata panjang dalam tabel Markdown mungkin membuat tabel diperluas ke navigasi kanan dan menjadi tidak dapat dibaca. Anda dapat menyelesaikannya dengan memungkinkan penyajian untuk secara otomatis menyisipkan pemisah baris dalam kata-kata saat diperlukan. Cukup bungkus tabel dengan kelas [!div class="mx-tdBreakAll"]kustom .

Berikut adalah sampel Markdown tabel dengan tiga baris yang akan dibungkus dengan div nama mx-tdBreakAllkelas .

> [!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.|

Ini akan dirender seperti ini:

Nama	Sintaks	Wajib untuk penginstalan senyap?	Deskripsi
Tenang	/Tenang	Ya	Menjalankan alat penginstal, tidak menampilkan UI dan tanpa perintah.
NoRestart	/norestart	Tidak	Menekan setiap upaya untuk memulai ulang. Secara default, UI akan meminta sebelum memulai ulang.
Bantuan	/help	Tidak	Menyediakan bantuan dan referensi cepat. Menampilkan penggunaan perintah penyiapan yang benar, termasuk daftar semua opsi dan perilaku.

Pemisah baris dalam kata dalam sel tabel kolom kedua

Anda mungkin ingin hentian baris secara otomatis disisipkan dalam kata-kata hanya di kolom kedua tabel. Untuk membatasi hentian ke kolom kedua, terapkan kelas mx-tdCol2BreakAll dengan menggunakan div sintaks pembungkus seperti yang ditunjukkan sebelumnya.

Lebar kolom yang tidak konsisten antar tabel

Anda mungkin melihat bahwa lebar kolom tabel dalam artikel Anda terlihat ganjil atau tidak konsisten. Perilaku ini terjadi karena panjang teks dalam sel menentukan tata letak tabel. Sayangnya, tidak ada cara untuk mengontrol bagaimana tabel dirender. Ini adalah batasan Markdown. Meskipun akan terlihat lebih bagus untuk memiliki lebar kolom tabel yang konsisten, ini akan memiliki beberapa kerugian juga:

• Menginterlasi kode HTML dengan Markdown membuat topik lebih rumit dan mencegah kontribusi komunitas.
• Tabel yang Anda buat terlihat bagus untuk ukuran layar tertentu mungkin akhirnya terlihat tidak dapat dibaca pada ukuran layar yang berbeda karena mendahului penyajian responsif.

Tabel matriks data

Tabel matriks data memiliki header dan kolom pertama tertimbang, membuat matriks dengan sel kosong di kiri atas. Microsoft Learn memiliki Markdown kustom untuk tabel matriks data:

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

Contohnya dirender sebagai:

	Header 1	Header 2
Kolom pertama A	Sel 1A	Sel 2A
Kolom pertama B	Sel 1B	Sel 2B

Setiap entri di kolom pertama harus ditata sebagai tebal (**bold**); jika tidak, tabel tidak akan dapat diakses untuk pembaca layar atau valid untuk Microsoft Learn.

Tip

Learn Authoring Pack for VS Code menyertakan fungsi untuk mengonversi tabel Markdown biasa menjadi tabel matriks data. Cukup pilih tabel, klik kanan, dan pilih Konversi ke tabel matriks data.

Tabel HTML

Tabel HTML tidak disarankan untuk Microsoft Learn. Mereka tidak dapat dibaca manusia dalam sumber - yang merupakan prinsip utama Markdown.