Cara menggunakan
- Ketik Markdown di editor atau tekan “Coba contoh” untuk memuat dokumen dengan tabel dan daftar tugas.
- Lihat pratinjau yang diperbarui saat Anda mengetik. Beralih ke “Sumber HTML” untuk melihat markup yang dihasilkan.
- Aktifkan atau nonaktifkan GitHub Flavored Markdown maupun jeda baris tunggal agar sesuai dengan tempat teks akan dipublikasikan.
- Salin HTML ke CMS atau email, atau unduh hasilnya sebagai file .html atau .md.
Cara kerja
Markdown dikonversi menggunakan marked, parser open-source yang banyak digunakan dan mengikuti spesifikasi CommonMark serta, jika opsi GFM diaktifkan, GitHub Flavored Markdown: tabel dengan pipa dan perataan kolom, daftar tugas, ~~teks coret~~, serta tautan otomatis untuk URL biasa. Catatan kaki, matematika, dan diagram Mermaid tidak termasuk dalam spesifikasi tersebut dan akan ditampilkan sebagai teks biasa.
Markdown dapat memuat HTML mentah, dan HTML tersebut diteruskan tanpa perubahan, seperti pada kebanyakan perender Markdown. Untuk menjaga keamanan, pratinjau tidak pernah disisipkan ke halaman ini. Pratinjau ditampilkan dalam bingkai terisolasi yang tidak diizinkan menjalankan skrip, mengirim formulir, membuka pop-up, atau mengakses situs ini. Kebijakan keamanan kontennya juga memblokir skrip, stylesheet eksternal, font, dan bingkai. Tag <script> atau atribut onclick dalam Markdown Anda akan ditampilkan di sumber HTML, tetapi tidak akan dijalankan. Tautan dalam pratinjau hanya ditampilkan dan tidak dapat dibuka; salin URL-nya jika ingin mengunjunginya.
Pratinjau menggunakan stylesheet netral yang mirip dengan perender README umum; situs web atau GitHub Anda mungkin menata HTML yang sama secara berbeda. HTML yang disalin berupa fragmen tanpa gaya; file .html yang diunduh menyertakan stylesheet dasar agar tampilannya menyerupai pratinjau. HTML yang diunduh atau disalin tidak disanitasi. Jika memuat skrip, skrip tersebut akan berjalan di mana pun Anda menempelkan atau membukanya.
Contoh
Memeriksa README sebelum mengunggah
Tempel README.md untuk memeriksa apakah kolom tabel sejajar, daftar tugas ditampilkan sebagai kotak centang, dan blok kode menggunakan pagar dengan benar sebelum file diunggah ke GitHub.
Menulis untuk CMS yang menerima HTML
Tulis draf postingan blog dalam Markdown, lalu tekan “Salin HTML” dan tempel markup <h2>, <p>, serta <ul> ke editor HTML CMS.
Jeda baris ala chat
Teks dari aplikasi chat memiliki baris-baris yang dipisahkan oleh jeda baris tunggal. Aktifkan “Perlakukan jeda baris tunggal sebagai <br>” agar baris-baris tersebut tetap terpisah dan tidak digabung menjadi satu paragraf.
Pertanyaan yang sering diajukan
Apakah aman menempelkan Markdown dari sumber yang tidak dikenal?
Ya, untuk pratinjau. HTML hasil render ditampilkan dalam bingkai terisolasi dengan skrip dinonaktifkan, jadi tag <script> atau pengendali peristiwa dalam teks tidak akan melakukan apa pun di sini. Berhati-hatilah saat menempelkan HTML yang diekspor, karena HTML tersebut tidak disanitasi.
Mengapa gambar saya tidak muncul?
Gambar dari situs web lain diblokir secara default agar pratinjau tidak membuat permintaan jaringan. Aktifkan “Muat gambar dari situs web lain” untuk menampilkannya. Jalur relatif seperti ./docs/screenshot.png tidak dapat digunakan karena file tersebut tidak tersedia di sini.
Apakah fitur ini mendukung catatan kaki, matematika, atau diagram?
Tidak. Fitur ini mendukung CommonMark dan GitHub Flavored Markdown (tabel, daftar tugas, teks coret, dan tautan otomatis). Catatan kaki, matematika LaTeX, dan diagram Mermaid adalah ekstensi yang ditampilkan sebagai teks biasa oleh pratinjau ini.
Mengapa jeda baris tunggal tidak membuat baris baru?
Dalam Markdown standar, jeda baris tunggal di dalam paragraf dianggap sebagai spasi. Akhiri baris dengan dua spasi, sisipkan satu baris kosong, atau aktifkan “Perlakukan jeda baris tunggal sebagai <br>”.
Privasi
Markdown dikonversi di browser Anda dan tidak diunggah atau disimpan. Pratinjau tidak memuat apa pun dari internet, kecuali jika Anda mengizinkan gambar dari situs web lain; gambar tersebut akan diminta langsung dari host-nya.