File .md dan .mdx adalah format yang digunakan untuk menulis konten berbasis teks dengan Markdown, tetapi ada perbedaan utama antara keduanya. Berikut adalah penjelasan lengkapnya:
Apa itu file .md?
File dengan ekstensi .md adalah file Markdown biasa. Markdown adalah format ringan yang digunakan untuk menulis teks dengan gaya sederhana, seperti membuat heading, daftar, tautan, atau format teks lain. Markdown sering digunakan untuk membuat dokumentasi, README di GitHub, atau konten blog.
Fitur Utama Markdown (.md)
- Penulisan teks sederhana: Markdown dirancang agar mudah dibaca dalam format mentah tanpa harus diubah ke HTML.
- Konversi ke HTML: Markdown dapat dikonversi menjadi HTML untuk ditampilkan di website.
- Sintaks dasar: Markdown menggunakan sintaks khusus untuk menulis format teks. Contoh:
- Heading:
CopyEdit
# Heading 1
## Heading 2
### Heading 3
- Teks tebal dan miring:
markdown
CopyEdit
**Teks Tebal**
*Teks Miring*
- Daftar:
markdown
CopyEdit
- Item 1
- Item 2
Apa itu file .mdx?
File .mdx adalah ekstensi untuk MDX, yaitu Markdown yang mendukung komponen React. Dengan kata lain, MDX adalah gabungan antara Markdown dan JSX. Kamu bisa menulis konten Markdown seperti biasa, tetapi juga menyisipkan dan menggunakan komponen React langsung di dalamnya.
Fitur Utama MDX (.mdx)
- Gabungan Markdown dan JSX:
- Kamu bisa menulis teks Markdown dan menyisipkan kode atau komponen React di file yang sama.
- Contoh:
mdx
CopyEdit
# Halo, Dunia!
Ini adalah konten biasa dengan Markdown.
 alert('Halo!')}>Klik Saya
Di sini, Â adalah komponen React yang bisa digunakan langsung dalam file .mdx.
- Interaktivitas:
- MDX memungkinkan kamu membuat konten dokumentasi yang lebih interaktif, seperti menambahkan tombol, grafik, atau elemen lain dengan React.
- Digunakan di Framework Modern:
- MDX biasanya digunakan di framework modern seperti Docusaurus, Next.js, atau Gatsby untuk dokumentasi dan blog.
Perbedaan Utama antara .md dan .mdx
Aspek
.md
.mdx
Sintaks
Hanya mendukung Markdown
Markdown + JSX (React Components)
Komponen React
Tidak bisa digunakan
Bisa menyisipkan komponen React
Interaktivitas
Statik (hanya teks)
Interaktif (menggunakan React)
Kegunaan
Dokumen sederhana
Dokumen interaktif dengan elemen React
Performa
Lebih ringan
Sedikit lebih berat karena menggunakan React
Kapan Menggunakan .md atau .mdx?
- Gunakan .md jika:
- Kamu hanya perlu membuat konten statik tanpa interaktivitas.
- Fokusmu adalah dokumentasi sederhana, seperti README proyek di GitHub.
- Gunakan .mdx jika:
- Kamu ingin menyisipkan komponen React ke dalam konten.
- Membutuhkan interaktivitas, seperti demo kode, tombol, atau elemen visual lainnya.
- Kamu menggunakan framework seperti Docusaurus atau Next.js.
Ada bagian lain yang ingin kamu pelajari tentang penggunaan file .md atau .mdx?
Follow Instagram @kompasianacom juga Tiktok @kompasiana biar nggak ketinggalan event seru komunitas dan tips dapat cuan dari Kompasiana. Baca juga cerita inspiratif langsung dari smartphone kamu dengan bergabung di WhatsApp Channel Kompasiana di SINI