Dua representasi dari dokumen
Markdown memungkinkan seorang penulis untuk menandai judul, penekanan, daftar dan tautan dengan tanda baca pendek. HTML menyebut struktur-struktur tersebut dengan elemen seperti h2, strong, ul dan a. Sebuah renderer menginterpretasi Markdown dan menulis HTML; itu tidak hanya menggantikan setiap asterisk atau karakter hash. Konteks penting: hash di dalam teks biasa berbeda dari penanda judul di awal sebuah baris. HTML juga memiliki atribut, elemen bersarang dan aturan pembacaan browser yang Markdown shorthand mungkin tidak mengekspresikan.
Gunakan Markdown ketika sumber harus tetap mudah untuk disunting dalam teks biasa. Gunakan HTML ketika tujuan mengharapkan elemen eksplisit atau ketika Anda perlu memeriksa apa yang akan diterima oleh peramban. Sebelum mengonversi, identifikasikan dialek Markdown yang diterima oleh tujuan. MultiVerto mengendalikan subset yang terdokumentasi: judul, paragraf, daftar bullet sederhana, penekanan, tautan dan kode inline di kedua arah. Blok kode berpagar hanya didukung saat mengubah Markdown ke HTML. Beberapa konstruksi yang tidak didukung ditolak; yang lain muncul sebagai teks literal.
Konversi yang berhasil dan kembalinya
Masukkan judul ## Catatan, baris kosong, lalu kalimat Draf yang **siap** dan [sumber](https://example.com). Konverter Markdown ke HTML menghasilkan elemen h2 yang berisi Catatan dan paragraf dengan elemen strong di sekeliling kata siap. Sebuah browser menampilkan judul dan kata tebal, sementara sumber HTML mempertahankan batas elemen. Contoh di bawah juga memuat tautan web; hrefnya tetap menjadi atribut daripada tanda baca yang terlihat dalam kalimat yang dihasilkan. Contoh pada konverter tersemat: masukan ## Catatan Draf yang **siap** dan [sumber](https://example.com).; hasil <h2>Catatan</h2> <p>Draf yang <strong>siap</strong> dan <a href="https://example.com">sumber</a>.</p>.
Sekarang masukkan yang didukung HTML ke dalam HTML-to-Markdown tool. Hal ini dapat mengekspresikan h2 sebagai Markdown heading, kuat sebagai pasangan asterisk dan tautan sebagai teks berpasangan plus URL. Teks dapat terlihat sama setelah kedua konversi bahkan ketika ruang kosong, pembagian baris atau ejaan sumber yang tepat berbeda. Bandingkan struktur yang terlihat dan target link, bukan hanya sebuah byte-by-byte match dengan Markdown asli.
- Markdown: ## Catatan dan **siap**
- HTML: h2 dan elemen kuat
- Markdown lagi: periksa judul, penekanan dan tautan
Mengapa perjalanan pulang-pergi bisa kehilangan informasi
HTML memiliki struktur dan atribut yang tidak setara dengan Markdown sederhana. Sebuah span bergaya, tabel, atribut data custom atau daftar bersarang mungkin tidak bertahan dari konversi HTML-ke-Markdown; alat lokal ini menolak banyak kasus seperti itu. Di arah lain, parser Markdown bervariasi dalam dukungan untuk tabel, daftar tugas, kutipan blok dan raw HTML. MultiVerto menolak beberapa dari ini daripada secara diam-diam menemukan keluaran. Konversi yang berhasil dari contoh kecil yang didukung oleh karena itu tidak menyetujui dokumen kompleks.
Bahkan struktur yang didukung dapat ditulis dengan beberapa cara. Sebuah elemen kuat HTML dan elemen b dapat menjadi asterisk berpasangan, sehingga pilihan tag asli menghilang. Browser juga dapat memperbaiki HTML yang rusak. Sebelum menerbitkan materi yang diubah, periksa markup yang dihasilkan dan renderkannya di sistem target. Simpan berkas asli sehingga Anda dapat memulihkan komentar, keputusan tata letak atau atribut yang representasi yang lebih sederhana tidak dapat mempertahankan.
Escape teks adalah operasi berbeda
Mengenkodekan karakter HTML untuk tampilan tidak sama dengan mengubah Markdown menjadi struktur HTML. Jika Anda ingin pembaca melihat teks literal <h2>Catatan</h2> di dalam halaman, wakili tanda kurung sudut sebagai entitas HTML atau letakkan dalam konteks kode yang dipercaya. Jika Anda ingin sebuah judul, emit elemen h2 yang sebenarnya. Encoder entitas HTML yang terhubung di bawah ini menangani representasi teks; konverter Markdown menciptakan elemen. Perlakukan konten yang disediakan pengguna sebagai tidak dipercaya dalam salah satu path.
Konverter lokal melarikan diri teks biasa dalam subset Markdown yang didukungnya, tetapi aliran kerja penerbitan nyata harus masih menggunakan parser yang dipertahankan dan sanitasi yang sesuai ketika input penulis arbitrari dapat mengandung tautan atau markup. Periksa aturan tujuan untuk URL dan tag yang diizinkan. Sebuah tinjauan praktis adalah untuk mengonversi contoh kecil, memeriksa sumber HTML, membuatnya, kemudian membalikkan hanya bagian yang didukung. Ketika kembali kehilangan fitur, simpan sumber yang lebih kaya sebagai salinan otoritas.