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

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

Example:

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:

Tulis ini:

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 true
content
gambar dan complex
, jadi Anda akan mendapatkan batas secara otomatis kecuali Anda secara eksplisit menambahkan properti dengan nilai false
. Properti border
secara default untuk false
icon
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:
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:
- Ini adalah
- daftar bernomor induk
- dan ini adalah
- daftar bernomor berlapis
- (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:
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:
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:
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-tdBreakAll
kelas .
> [!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.