Pratinjau Markdown
Lihat Markdown Anda dirender saat Anda mengetik, di browser Anda, dengan semua HTML mentah di-escape alih-alih dijalankan.
Berjalan sepenuhnya di browser Anda. Tidak ada yang diunggah, dicatat, atau disimpan.
HTML yang dihasilkan
Tulis Markdown di sebelah kiri dan baca hasilnya di sebelah kanan. Semuanya terjadi di browser Anda, jadi draf yang belum ingin Anda tunjukkan kepada siapa pun tidak perlu ditunjukkan dulu ke server.
Cara kerja
Dokumen dibaca baris demi baris menjadi blok — judul, paragraf, daftar, kutipan, kode, tabel — lalu teks setiap blok dibaca untuk mencari bagian sebaris: penekanan, potongan kode, tautan, dan gambar. Apa pun yang tidak dikenali perender tetap menjadi teks.
HTML mentah di-escape, tidak diloloskan. Jika Anda mengetik sebuah tag, Anda melihat tag itu. Ini penyimpangan yang disengaja dari kebanyakan perender, yang mengizinkan subset terpilih, dan alasannya adalah bahwa memilih subset itu dengan benar merupakan pekerjaan yang sudah berkali-kali gagal di proyek yang jauh lebih besar.
Tautan hanya dibuat jika alamatnya diawali skema dari daftar pendek, yang diperiksa pada bentuk alamat yang sudah didekode, bukan pada apa yang diketik. Jika ditolak, teksnya tetap ada dan tautannya tidak, sehingga Anda bisa melihat bahwa ada sesuatu di sana.
Contoh
| Kasus | Masukan | Hasil |
|---|---|---|
| Penekanan dan kode inline | **bold**, *italic* and `code`. | <p><strong>bold</strong>, <em>italic</em> and <code>code</code>.</p> |
Pertanyaan umum
Apakah dokumen saya dikirim ke suatu tempat?
Tidak. Perendernya adalah JavaScript yang berjalan di halaman ini. Tidak ada yang diunggah, dicatat, atau disimpan: Anda bisa memutus jaringan dan alat ini tetap berfungsi.
Mengapa HTML saya muncul sebagai teks?
Karena memang sengaja di-escape. Markdown membolehkan dokumen berisi HTML, dan meloloskan HTML itu berarti memutuskan tag dan atribut mana yang aman — keputusan yang rumit, yang berubah seiring perubahan browser, dan yang sudah lebih dari sekali gagal di proyek dengan sumber daya jauh lebih besar. Meng-escape semuanya tidak punya celah kegagalan seperti itu. Konsekuensinya, dokumen yang mengandalkan HTML sebaris tidak akan tampil seperti di GitHub, dan itulah pertukaran yang dipilih.
Apakah ini persis CommonMark?
Tidak, dan mengatakan ya akan menyesatkan. Ini adalah subset, ditambah tabel, daftar tugas, dan coretan dari varian GitHub. Yang dicakup: judul, paragraf, penekanan, potongan dan blok kode, tautan, gambar, daftar bertingkat, kutipan, dan garis pemisah. Tautan referensi, catatan kaki, dan blok HTML tidak diimplementasikan.
Mengapa gambar dari situs lain tidak muncul?
Karena halaman ini tidak mengizinkan dirinya memuat gambar dari situs lain. Mengambil gambar akan memberi tahu server itu bahwa Anda sedang membaca dokumen ini, dan pada jam berapa — justru kebocoran yang ingin dihindari oleh pratinjau lokal. Tag gambarnya ada di HTML keluaran, jadi gambar itu berfungsi di mana pun Anda menempelkannya: hanya saja tidak dimuat dari sini.
Bagaimana dengan tautan seperti javascript:…?
Tautan itu tidak dibuat. Skemanya dicocokkan dengan daftar pendek — http, https, mailto, tel, ftp, atau tanpa skema untuk path relatif — dan pemeriksaan dilakukan pada alamat yang sudah didekode, karena browser menguraikan entitas dalam atribut sebelum menindaklanjutinya. Teks tautan tetap terlihat agar Anda bisa melihat apa yang ada di sana.
Perlu diketahui
- HTML yang ditampilkan pratinjau adalah HTML yang diberikan alat ini kepada Anda. Hanya ada satu keluaran, bukan satu versi aman untuk ditampilkan dan versi lain untuk disalin.
- Judul tidak diberi atribut id. Id yang diambil dari dokumen Anda akan berbagi namespace dengan id di halaman ini, dan tabrakan bisa merusak halaman di sekitar pratinjau.
- Tautan ke situs lain diberi rel="nofollow noopener noreferrer", sehingga halaman yang dibuka dari sini tidak mendapat kendali apa pun atas halaman ini.