Konverter online gratis MMD ke RST

Proyek yang menggunakan Sphinx, Docutils, atau sistem dokumentasi berbasis reStructuredText lainnya memerlukan file .rst, bukan source MultiMarkdown. Mengonversi dokumen akan mempertahankan heading, daftar, tautan, blok kode, dan struktur lain yang didukung dalam format plain-text yang dapat diedit.

Apa itu format MMD

MMD biasanya berarti MultiMarkdown, yaitu format Markdown yang diperluas dan disimpan sebagai file plain-text .mmd. Format ini menambahkan fitur seperti metadata, tabel, footnote, citation, definition list, dan cross-reference ke Markdown standar.

File MultiMarkdown dibuat oleh command-line tools MultiMarkdown dan oleh editor Markdown yang mendukung sintaks MultiMarkdown. Anda mungkin menemukannya dalam proyek penulisan, repositori dokumentasi teknis, dan source file yang disiapkan untuk dikonversi ke HTML, PDF, atau format dokumen lainnya.

Apa itu format RST

RST, atau reStructuredText, adalah format markup plain-text terstruktur yang digunakan oleh Docutils, Sphinx, dokumentasi Python, dan documentation generator. Section marker, directive, role, label, dan field list eksplisitnya membuat format ini sesuai untuk proyek dokumentasi besar dan automated build.

RST berguna ketika sistem tujuan mengharapkan file yang diakhiri dengan .rst, terutama proyek Sphinx. RST juga mendukung admonition, API directive, internal reference, tabel, literal code block, dan metadata field, meskipun beberapa fitur MultiMarkdown memerlukan penyesuaian manual setelah konversi.

Cara mengonversi MMD ke RST

Menggunakan Pandoc

Pandoc adalah opsi desktop atau command-line yang paling praktis untuk konversi terstruktur. Instal rilis Pandoc terbaru, buka terminal di folder yang berisi source file, lalu jalankan:

pandoc input.mmd -f markdown_mmd -t rst -o output.rst

Reader markdown_mmd memberi tahu Pandoc untuk menafsirkan source sebagai MultiMarkdown, sedangkan rst memilih output reStructuredText. Ganti input.mmd dan output.rst dengan nama file yang sebenarnya.

Untuk dokumen yang menggunakan sintaks Markdown standar, bukan extension khusus MultiMarkdown, alternatif berikut biasanya sudah memadai:

pandoc input.mmd -f markdown -t rst -o output.rst

Buka file yang dihasilkan dalam text editor, periksa section underline dan directive yang dibuat, lalu build dengan Sphinx atau Docutils. Dalam proyek Sphinx, letakkan output.rst di documentation source directory dan jalankan build command normal proyek tersebut.

Menggunakan online converter

Anda dapat mengonversi file secara gratis di website 101convert.com tanpa menginstal software: pilih file MMD, pilih RST sebagai format output, mulai konversi, lalu download file .rst yang dihasilkan.

Keterbatasan kualitas dan kompatibilitas

• Metadata MultiMarkdown dapat menjadi sintaks RST field-list, paragraf biasa, atau komentar dokumen, bergantung pada field dan versi Pandoc; verifikasi title, author, date, dan metadata lainnya secara manual.
• Heading, emphasis, tautan, gambar, ordered list, fenced code block, dan banyak tabel umumnya dapat dikonversi dengan baik, tetapi RST memerlukan section underline yang unik dan indentasi yang lebih ketat.
• Citation MultiMarkdown, transclusion, special attribute, dan custom extension mungkin tidak memiliki padanan langsung dalam RST. Pandoc dapat mempertahankan material yang tidak didukung sebagai raw text, tetapi tidak dapat mereproduksi perilaku yang tidak diimplementasikan oleh RST atau target builder.
• Periksa image path, link target, anchor, footnote, dan escaping setelah konversi. Sphinx mungkin memerlukan label eksplisit seperti .. _label: dan directive seperti .. code-block:: python untuk fitur yang bersifat implisit dalam source MMD.