- Menggabungkan penulisan dokumen berbasis Markdown dengan kemampuan typesetting setingkat LaTeX, sehingga makalah, buku, presentasi, situs statis, hingga basis pengetahuan bisa ditangani dalam satu alat
- Di dalam sintaks yang mengurangi boilerplate, elemen seperti penulis, margin, abstrak, gambar, dan kutipan bisa dimasukkan langsung sehingga isi dan tata letak dapat ditulis bersamaan
- Dengan satu baris pengaturan
.doctype, jenis dokumen paged, plain, docs, dan slides bisa diganti, serta mendukung presentasi interaktif
- Menyediakan kompilasi cepat dan live preview, dan melalui scripting Turing complete, pekerjaan tata letak yang berulang bisa dikurangi lewat penggunaan ulang fungsi dan argumen
- Tersedia sebagai open source gratis, memiliki lebih dari 10K stars di GitHub, integrasi VS Code, serta materi Quickstart dan dokumentasi yang memperluas jalur penggunaan nyata dan pengembangan
Fitur utama
- Sistem penulisan dokumen modern yang menggabungkan Markdown dengan kemampuan typesetting setingkat LaTeX
- Dirancang agar makalah, buku, presentasi, situs statis, hingga basis pengetahuan dapat ditangani dalam satu alat
- Tersedia gratis sebagai open source, kompiler terus berkembang, dan dipertahankan sebagai perangkat lunak bebas
- Quarkdown, Wiki, Discuss
Pengalaman menulis
- Dirancang agar pengguna bisa fokus menulis tanpa boilerplate
- Elemen seperti
docauthor, pagemargin, abstract, gambar, dan kutipan dapat dimasukkan langsung ke dalam sintaks sehingga tata letak dokumen dan isi bisa dikelola bersama
- Dokumen contoh disusun dengan alur menulis judul, penulis, margin, gambar, abstrak, dan kutipan bersama-sama dalam satu berkas
- Melalui sintaks yang diperluas, ekspresi yang lebih kaya dimungkinkan dibanding Markdown dasar
Jenis dokumen dan doctype
- Jenis dokumen diubah dengan satu baris pengaturan
.doctype
paged digunakan untuk artikel, buku, dan laporanplain digunakan untuk catatan, basis pengetahuan, dan situs web statis sederhanadocs digunakan untuk wiki, dokumentasi teknis, dan basis pengetahuan berskala besarslides digunakan untuk kuliah, presentasi, dan presentasi interaktif
Pratinjau responsif dan scripting
- Melalui kompilasi cepat dan live preview, hasil bisa langsung dilihat saat mengetik
- Menyertakan fitur scripting Turing complete untuk mengurangi pekerjaan berulang
- Dengan definisi fungsi dan penggunaan ulang argumen, pola tata letak yang sama dapat diterapkan ke banyak item
- Dalam contohnya, fungsi
animal didefinisikan lalu komposisi nama, ekosistem, dan ilustrasi digunakan ulang untuk membuat beberapa item
Instalasi dan jalur memulai
Ekosistem dan materi
- Ditampilkan telah memperoleh lebih dari 10K stars di GitHub
- Menyediakan jalur belajar dan integrasi editor melalui Quickstart, Docs, VS Code, Wiki
1 komentar
Komentar Hacker News
Jujur ini memang mengesankan, tapi bagi saya inti Markdown adalah kesederhanaannya yang ekstrem
Bisa diedit tanpa GUI, ditulis di VIM dalam terminal pun kita masih bisa membayangkan hasilnya akan kira-kira seperti apa, dan file
.mdmentahnya sendiri juga enak dibacaTapi kalau terus ditambahi fitur, jadinya kita harus terus mencari perintah-perintah asing, lalu akhirnya tidak hafal juga, dan tanpa rendering pun tidak yakin tampilannya seperti apa, sampai-sampai jadi ingin editor WYSIWYG
Rasanya mirip gagasan memasukkan huruf Kiril, Devanagari, Tionghoa, dan Arab ke keyboard QWERTY sekaligus, lalu pada akhirnya kembali ke hunt and peck
Sintaks dasarnya memanfaatkan ulang cara orang biasanya meniru format dalam teks, jadi input-nya sendiri umumnya tetap nyaman dibaca apa adanya
Walau tidak tahu persis cara menulis Markdown, biasanya tetap tidak ada masalah saat membacanya; tabel tetap terlihat seperti tabel, dan paragraf ya terlihat seperti paragraf
Kadang saya memang harus mengecek lagi sintaksnya, tapi itu tidak masalah. Kosakata pasif yang lebih besar daripada kosakata aktif itu wajar
Jadi saya cenderung menilai dari keterbacaan teks sumbernya, dan cukup banyak yang ditunjukkan di sini tampaknya tidak memberi untung-rugi besar menurut kriteria itu
Tapi saya belum melihat contoh formatting rumus, dan kasus langka ketika saya memakai LaTeX pun biasanya karena ekspresi matematika yang tidak bisa dilakukan di Markdown, jadi saya penasaran seperti apa bagian itu terlihat dalam praktik
Meski begitu, Quarkdown jelas terlihat lebih unggul daripada mengetik LaTeX langsung, dan juga tampak lebih bisa diprediksi hasilnya serta lebih cocok untuk penyuntingan berbantuan LLM dibanding editor GUI seperti Word
Namanya bisa Microsoft Word
Belakangan ini, editor "plain markdown" biasa saja susah menonjol, dan untuk sampai ke halaman depan HN sepertinya memang perlu fitur dan kematangan yang melampaui Markdown biasa
Rasanya seperti seleksi alam
Akan bagus kalau ada materi yang membandingkan alat dan bahasa markup seperti ini sekaligus
Menarik kalau MyST, Pandoc, Quarkdown, Quarto, dan Typst ditaruh berdampingan
Quarto dan Pandoc memakai Pandoc Markdown, dan https://www.zettlr.com/ juga demikian
Sementara Quarkdown dan Typst terasa lebih seperti bahasa markup yang bisa diprogram yang lebih dekat ke LaTeX atau HTML+Javascript, jadi tampaknya belum jelas siapa yang benar-benar akan jadi penerus LaTeX
Markdown itu pada dasarnya
.txtyang diberi sedikit gula sintaks dan bisa diekspor ke PDF atau HTMLQuarto adalah Markdown kalau Anda ingin menjalankan code block
Typst adalah LaTeX yang dibuat ulang secara modern, jadi 90% hal merepotkan hilang, tapi rasanya juga ada 10% fitur yang ikut hilang
Dunia akademik memang cenderung tidak suka hal baru, jadi walau memakai Typst, kemungkinan mereka tetap tidak terlalu antusias
Pandoc pada akhirnya adalah alat untuk mengekspor ke berbagai format seperti PDF, HTML, dan lain-lain
Biasanya cepat terlihat alat mana yang dibutuhkan, dan memang ada juga hal seperti asciidoc, tapi kalau dipikir-pikir area apa yang tidak tercakup oleh kombinasi markdown/quarto/typst, ternyata tidak banyak
Yang tersisa paling editor WYSIWYG
Kelihatannya seperti superset Markdown yang dirancang dengan baik dan cukup matang
https://djot.net/
Akan luar biasa kalau saya tidak perlu lagi memakai LaTeX, tapi setelah mencobanya di proyek nyata, ternyata ada terlalu banyak corner case sehingga saya akhirnya kembali ke LaTeX
Ada bagian yang ada di LaTeX tapi belum ada di sana, dan kurangnya kemampuan konversi Pandoc juga cukup terasa
Saya benar-benar berharap 10% terakhir itu segera terpenuhi
https://github.com/iamgio/quarkdown#comparison
Karena bisa menerapkan filter arbitrer terhadap format JSON perantara, pada dasarnya kita bisa mengimplementasikan hampir transformasi apa pun yang diinginkan, dan ia juga bisa mengubah berbagai format ke JSON itu atau sebaliknya
Karena itu saya lebih suka sistem berbasis Pandoc, dan hal yang tidak bisa dilakukan alat bawaannya pun sering bisa diselesaikan dengan inline filter sederhana
Menurut model standar perangkat lunak fisika, Quarkdown kalau diedit di Atom akan menjadi Quarkup, dan Neutron Mail harus diganti menjadi Proton Mail
Tentu ini hanya bekerja jika Anda mengetik dengan tangan kiri sambil membuat aplikasi Electron dan juga menulis anti-Neutrinos AI blogpost
Penilaian singkat saya: ini pada dasarnya lebih dekat ke Markdown yang diberi makro bergaya LaTeX
Hanya saja di sini itu disebut fungsi, mungkin karena ada setidaknya satu fungsi yang punya efek samping, yaitu fungsi untuk mendefinisikan fungsi baru
Saya suka kemurnian sintaksis "semuanya adalah fungsi", tetapi pencampuran struktur dan styling yang natural ala HTML/CSS terasa agak rumit. Walau memang batas di antara keduanya sejak awal juga tidak pernah benar-benar tegas
Tetap saja ini cukup keren, dan saya paham kenapa banyak orang bereaksi skeptis terhadap upaya mengubah Markdown secara besar-besaran
Kritik bahwa penggunaan fungsi berlebihan bisa menurunkan keterbacaan sumber juga benar, dan kadang ketidaklengkapan Turing justru menjadi kelebihan
Tapi kalau dilihat semata sebagai desain untuk menambahkan fungsi ke Markdown, menurut saya ini termasuk desain yang rapi
Saya adalah penulis Quarkdown sekaligus project lead-nya
Awalnya ini dimulai sebagai proyek riset kampus, dan saya sama sekali tidak menyangka dua tahun kemudian bentuknya akan jadi seperti ini
Terima kasih atas ketertarikannya, saya akan mencoba menjawab komentar sebanyak mungkin
Saya selalu merasa
**bold**dan*italic*kurang pas dibanding*bold*dan_italic_Tanda bintang tambahan di Markdown itu desain yang kurang bagus, dan terutama cukup merepotkan saat mengedit Markdown di ponsel atau tablet
Bahkan di dokumen GUI pun makro biasanya dihindari, jadi saya penasaran apakah Quarkdown dari awal memang dirancang untuk dokumen yang kompleks dan repetitif
Terima kasih sudah membuka sesi tanya jawab
Setelah membaca dokumentasinya sekilas, saya agak khawatir apakah model evaluasi-nya cocok untuk pekerjaan seperti ini
Tata letak teks biasanya memerlukan struktur yang berulang sampai mencapai titik tetap, karena ketika satu bagian diubah, penempatan bagian lain bisa ikut rusak dan perlu melewati layout pass lagi
Typst punya konsep context untuk ini, https://typst.app/docs/reference/context/ tetapi saya tidak melihat hal serupa di Quarkdown. Mungkin saya yang melewatkannya
Untuk pekerjaan buku, saya beralih dari kombinasi pandoc/md/LaTeX ke Typst, dan sejauh ini cukup puas
Rasanya seperti memprogram dalam bahasa modern, dan kecepatannya juga jauh lebih tinggi daripada pandoc+LaTeX
https://functionalprogrammingstrategies.com/
Dari sudut pandang AsciiDoc, desain sintaks Quarkdown terlihat rapi, dan khususnya fungsi yang didefinisikan pengguna tampak bagus
Tapi menurut saya yang lebih sulit dalam kategori ini bukan bahasa sumbernya sendiri, melainkan pipeline output-nya
Ekstensi Markdown seperti referensi silang, admonition, konten bersyarat, dan reuse berbasis fungsi pada dasarnya masih bisa ditangani dengan baik dari sisi desain
Hambatan sesungguhnya ada setelah itu, misalnya tagged PDF yang memenuhi PDF/UA, deterministic build yang tidak goyah meski lingkungannya berbeda, hreflang dan cross-document linking untuk situs dokumentasi multibahasa, atau incremental rebuild yang tetap kuat bahkan untuk buku 500 halaman
Terutama di Uni Eropa, pentingnya PDF/UA makin besar setelah European Accessibility Act mulai berlaku pada 28 Juni 2025
Saya penasaran apa rencananya untuk empat doctype itu, terutama sisi paged
MyST juga seharusnya masuk ke tabel perbandingan
https://mystmd.org/
Ini terlihat berpotensi menjadi standar Markdown baru ke depannya
Memang bukan ekstensi Markdown, tapi tujuan dan use case-nya cukup mirip
Hanya saja dukungan LSP yang kuat masih kurang, setidaknya saya belum berhasil membuatnya berjalan dengan baik di helix
Blog saya juga dibuat dengan pydata-sphinx-theme dan myst
Kalau mau, silakan langsung perbarui tabelnya lewat PR
Di aplikasi saya, saya mengambil pendekatan yang agak berbeda
Fokus saya lebih ke keterbacaan dan kemudahan menangani diagram Mermaid berukuran besar, dan belakangan saya juga menambahkan mode layar penuh untuk menjelajah seperti peta
https://mdview.io/s/97af684b
Saat memakai SSG, saya lebih suka menjaga input tetap berupa Markdown yang bersih semaksimal mungkin, lalu semua detail format dipindahkan ke CSS
Misalnya tanpa perlu menulis
.abstract, CSS saja bisa dibuat menangani paragraf pertama seperti abstractSebaliknya, proyek ini tampaknya bergerak ke arah dokumen yang lebih kaya dan mandiri
Tidak ada CSS, tetapi ada banyak opsi styling bawaan, dan karena itu saya terus teringat pada HTML awal
HTML 1 tidak punya warna dan hampir tidak punya formatting, jadi mirip Markdown, sedangkan sekitar HTML 3 mulai banyak hal ditambahkan, sehingga alurnya terasa serupa