Sintaks Org Mode adalah salah satu bahasa markup paling rasional untuk teks (2017)

 (karl-voit.at)
3 poin oleh GN⁺ 2026-01-12 | 1 komentar | Bagikan ke WhatsApp
  • Sintaks Org Mode diperkenalkan sebagai bahasa markup ringan yang intuitif dan konsisten yang dapat digunakan di luar Emacs
  • Sintaks dasar seperti judul, daftar, format teks, dan tautan memiliki struktur yang sederhana dan mudah diingat, serta konsistensi ekspresi yang lebih tinggi dibanding bahasa lain
  • Berbeda dari berbagai turunan Markdown, Org Mode mempertahankan bentuk yang relatif terstandarisasi dengan berpusat pada satu implementasi (Emacs Org-mode)
  • Dapat dikonversi melalui berbagai alat seperti Pandoc, dan mudah ditulis di editor teks biasa tanpa harus menggunakan Emacs
  • Di antara bahasa markup ringan, Org Mode menonjol dalam keterbacaan, kemudahan pemeliharaan, dan dukungan alat, serta ditekankan sebagai alternatif untuk penulisan dokumen berbasis teks biasa

Gambaran umum sintaks Org Mode

  • Sintaks Org Mode tidak bergantung pada Emacs, dan dapat digunakan di editor teks apa pun seperti vim, Atom, Notepad, dll.
    • Judul menggunakan *, **, ** * untuk mengekspresikan hierarki
    • Format teks menggunakan bentuk *bold*, /italic/, _underlined_, +strikethrough+, =monospaced=
    • Tautan sederhana dengan format [[URL][deskripsi]]
    • Juga mendukung daftar (-, 1.), kotak centang ([ ], [X]), blok kode (#+BEGIN_SRC ... #+END_SRC), dan lain-lain
  • Tabel memang sulit disejajarkan secara manual, tetapi sintaks tetap dapat dikenali meski perataan diabaikan
  • Pengguna dapat mempelajari sintaks secara alami tanpa cheat sheet terpisah

Standardisasi dan masalah Markdown

  • Markdown menimbulkan masalah kompatibilitas karena adanya banyak standar turunan (Original, Extra, MultiMarkdown, GitHub Flavored, CommonMark, dll.)
    • Meskipun sama-sama disebut “Markdown”, sintaks dapat berbeda antar alat, sehingga menyebabkan kehilangan data dan penurunan kegunaan
  • Org Mode memiliki semua sintaks yang didefinisikan berdasarkan satu implementasi, Emacs Org-mode, sehingga memungkinkan interpretasi yang konsisten
    • Alat turunan bekerja sebagai subset dari sumber aslinya
    • Ekstensi berkas selalu diseragamkan sebagai .org
  • Tidak ada dokumen standar resmi, tetapi implementasi Emacs berperan sebagai standar de facto (golden standard)

Perbandingan konsistensi dan kegunaan

  • Sintaks judul: Org Mode hanya memakai prefiks * untuk menyatakan hierarki secara sederhana
    • Markdown, AsciiDoc, reStructuredText, dan lainnya memiliki struktur yang kompleks dan tidak seragam, seperti prefiks/sufiks atau garis bawah
    • Beberapa bahasa juga mengizinkan gaya campuran, sehingga menambah kebingungan
  • Sintaks tautan: [[URL][teks]] pada Org Mode sederhana, tetapi
    • [teks](URL) pada Markdown atau `teks <URL>`_ pada reStructuredText memiliki kombinasi simbol yang lebih rumit dan kurang konsisten
  • Sintaks format teks: Org Mode menggunakan /italic/, *bold*, ~monospace~, +strikethrough+ dengan struktur sepasang simbol yang konsisten
    • Markdown memakai _italic_, **bold**, ~~strike~~, dan sebagainya, dengan jumlah simbol dan aturan yang tidak seragam

Kemudahan input dan kemandirian alat

  • Org Mode membutuhkan lebih sedikit input karakter yang tidak perlu, tanpa perataan manual atau sintaks yang rumit
  • Bahkan di luar Emacs, teks yang ditulis dengan sintaks Org Mode dapat dikonversi ke HTML, PDF, Word, dan format lain melalui Pandoc
  • GitHub dan GitLab juga dapat merender berkas Org, sehingga tetap efisien di lingkungan editor teks sederhana
  • Ditekankan bahwa “semakin minim dukungan alat dalam suatu lingkungan, semakin berguna sintaks Org Mode”

Dukungan alat di dalam Emacs

  • Di Emacs, saat menulis dengan Org Mode, struktur dapat dimanipulasi dengan TAB, Alt+panah, Ctrl+Return, dan lain-lain
    • Mendukung otomatisasi seperti lipat/buka judul, memindahkan daftar, serta memindahkan baris dan kolom tabel
  • Pendekatan berbasis menu juga tersedia, sehingga penulisan tetap efisien tanpa harus mempelajari banyak pintasan
  • Emacs tidak wajib digunakan, tetapi jika digunakan, ia menawarkan pengalaman penyuntingan markup yang paling kuat
  • Markdown, AsciiDoc, dan reStructuredText tidak memiliki dukungan alat pada tingkat yang sebanding

Kesimpulan dan usulan Orgdown

  • Tujuan bahasa markup ringan adalah keringkasan dan efisiensi, dan Org Mode dinilai memiliki desain yang paling rasional dalam hal ini
  • Markdown, AsciiDoc, dan reStructuredText memiliki kegunaan yang lebih rendah karena kurang konsisten dan sintaksnya rumit
  • Org Mode memiliki kurva belajar yang rendah, mandiri dari alat tertentu, dan kompatibilitas konversi yang tinggi
  • Setelah 2021, diskusi ini berkembang menjadi upaya standardisasi baru bernama Orgdown
    • Diperkenalkan sebagai proyek standardisasi markup ringan independen yang berbasis pada sintaks Org Mode

Diskusi tambahan dan umpan balik

  • Sebagian pengguna menyoroti tidak adanya standar resmi untuk Org Mode
    • Ada perbedaan interpretasi antara Emacs dan Pandoc, tetapi implementasi Emacs tetap dianggap sebagai acuan de facto
  • Ada pula masukan mengenai fitur referensi tautan pada reStructuredText, namun
    • Penulis tetap menilai Org Mode sebagai markup ringan yang paling logis dan mudah diingat
  • Pada akhirnya, Org Mode diposisikan sebagai alternatif rasional untuk penulisan dokumen teks biasa, melampaui ekosistem Emacs

Bacaan terkait

1 komentar

 
GN⁺ 2026-01-12
Komentar Hacker News
  • Saya mulai memakai Emacs pada 2016 saat pindah dari Evernote ke org-mode
    Sekarang saya memakai org-mode untuk semua proyek, tugas, dan manajemen pengetahuan. Ada juga file yang ukurannya lebih dari 15MB
    Awalnya saya cuma memakai header sederhana, tetapi setiap kali butuh sesuatu, fiturnya ternyata sudah tersedia. Jarang ada alat yang sekaligus mudah dipakai dan punya ekstensibilitas yang kuat
    • Saya penasaran bagaimana menangani rich text seperti PDF, gambar, dan HTML. Evernote sangat bagus untuk itu, jadi saya masih belum bisa meninggalkannya
    • Saya juga sudah memakai org-mode selama beberapa tahun, tetapi baru sebatas header dasar, pemformatan, tautan, dan blok kode
      Kalau ada fitur lanjutan yang layak dipelajari lebih dalam, saya ingin mendengar rekomendasinya
    • Kalau 15MB, itu mungkin sekitar 3 juta kata. Mengejutkan juga, hampir setara 60 novel
  • Format org sendiri memang intuitif, tetapi kekuatan sesungguhnya datang dari integrasinya dengan Emacs
    Bisa dipakai untuk personal information management (PIM), penulisan dokumen, catatan, shortcut otomatis, dan lain-lain
    Daripada sekadar dipakai sebagai pengganti Markdown, ia benar-benar bersinar di dalam ekosistem Emacs
    • Saya rasa nilainya akan jauh lebih besar jika format org juga diadopsi luas seperti Markdown di luar Emacs
      Tulisan Karl Voit berargumen bahwa sintaks org lebih konsisten dan ringkas daripada Markdown
      Di dunia teknologi, format yang lebih baik tidak selalu menang, tetapi menurut saya tetap layak diperjuangkan
    • Saya juga memakai Markdown setiap hari, tetapi sebenarnya merasa orgdown lebih praktis
      Tulisan terkait juga menekankan hal itu
  • Saya menulis semua buku saya dalam Markdown
    Dulu saya memakai XML, tetapi terlalu merepotkan jadi saya pindah. Saya menghasilkan HTML dan PDF dengan workflow berbasis Pandoc
    Belakangan ini saya membuat PDF lebih cepat dengan Typst.
    Saya membuat proyek xml2typ untuk menghasilkan PDF jauh lebih cepat daripada Pandoc/LaTeX
    • Typst bisa langsung membuat PDF, jadi saya penasaran apakah ada alasan khusus untuk tetap melewati docbook dan xsltproc
    • Saya sudah melihat repositorinya. Akan bagus kalau hasil PDF akhir dari test.md juga disertakan
  • Saya sudah lama mengusulkan org sebagai format pertukaran antar alat produktivitas
    org bisa menyatukan bookmark, PKM, sampai manajemen tugas
    Tetapi di era AI, Markdown sedang menjadi format default untuk pelatihan LLM
    Meski begitu, LLM juga memproses org dengan baik, jadi masih ada ruang bagi keduanya untuk hidup berdampingan
    Lihat tulisan usulan terkait
    • Fokus tulisan saya ada pada sintaks org-mode (orgdown). Pembahasan tentang alat seperti Sharepoint atau Jira adalah topik lain
    • Menurut saya, ConnectedText masih lebih unggul daripada org dalam hal kemudahan pencarian dan stabilitas
      Sayang tidak di-open-source-kan. Ini menunjukkan batasan proyek satu pengembang (SPOF)
    • Dari pengalaman saya, LLM juga menangani org-mode dengan baik. Ada cukup banyak data org di internet untuk dipelajari
  • Saya sudah mengatur hidup dengan org-mode selama 10 tahun
    Berkat Beorg untuk iOS, saya juga memakainya dengan baik di perangkat mobile
    Saya meningkatkan produktivitas dengan org-ql dan org-super-agenda
    Saya mencatat log kerja harian dalam file org, dan itu sangat membantu saat evaluasi akhir tahun
    • Saya merekomendasikan ekstensi browser saya, BrainTool
      Bookmark dan tab bisa disinkronkan dengan file org lalu dikelola sebagai TODO
    • Saya juga sedang memikirkan struktur jurnal kerja. Saya lebih suka heading berbasis konteks daripada berbasis tanggal
      Saya penasaran bagaimana Anda menyusun tautan antarfile. Saya juga sedang mempertimbangkan denote
  • Menurut saya, mengekspresikan HTML atau LaTeX yang kompleks dengan org-mode justru lebih sulit
    Jadi untuk hal yang kompleks, saya langsung menulis HTML atau LaTeX asli saja
    Program org-mode sendiri luar biasa, tetapi kalau hanya melihat sintaksnya, Markdown terasa lebih praktis
    Saat memindahkan blog dari org ke Markdown, kode menjadi lebih ringkas dan kecepatannya 50 kali lebih tinggi
    • Sebaliknya, saya justru pindah dari Markdown ke org
      Saya membuat site builder berbasis Bash dengan proyek shite, dan menyisipkan blok HTML langsung di dalam org
      Fitur untuk mengedit hanya HTML dengan org-edit-special sangat berguna
    • Kalau memakai blok kode (#+BEGIN_SRC html), Anda juga bisa mendapatkan highlighting per bahasa
      Akan lebih nyaman lagi kalau membuat shortcut dengan yasnippet
    • Di org, HTML/LaTeX bisa disisipkan dengan mudah
      Sejak 2009 saya menulis semua dokumen Beamer saya dalam org
      Untuk blog Pelican, saya juga menambahkan dukungan org lewat plugin Python
    • Saya juga memindahkan blog saya dari org ke Markdown
      org adalah ide yang keren, tetapi kurangnya kompatibilitas adalah masalahnya. Markdown didukung di mana-mana, jadi itu pilihan yang lebih realistis
  • Markdown sudah menjadi markup ringan standar
    Seberapapun masuk akalnya org-mode, secara realistis lebih masuk akal memakai Markdown yang sudah populer sebagai default
    • Markdown sebaiknya dipandang sebagai kata benda, sedangkan Org-mode sebagai kata kerja (sistem)
      Ini bukan sekadar perbandingan format, melainkan alat dengan cara kerja yang sepenuhnya berbeda
      Markdown hanya punya struktur, sedangkan Org mencakup state dan logika eksekusi
      Karena itu, perdebatan soal “pilihan default” sebenarnya tidak ada artinya. Pakai saja sesuai tujuan masing-masing
    • Jadi format file pribadi harus ditentukan berdasarkan popularitas?
      Tidak ada alasan untuk menyuruh orang berhenti memakai org-mode kalau itu cocok untuk mereka
    • Pada akhirnya ini soal selera. Seperti LaTeX vs Typst, pilih saja lingkungan yang paling cocok untuk diri sendiri
    • Menurut saya Markdown lebih enak dilihat dalam keadaan plain text
      Heading berbintang di org terasa lebih ramai secara visual. Meski begitu, saya suka notasi italic-nya
    • Markdown punya banyak ambiguitas dan masalah kompatibilitas
      Setiap implementasi berbeda, dan fitur seperti tabel atau footnote juga hadir sebagai ekstensi terpisah
      Satu-satunya keunggulannya hanyalah universalitas
  • Belakangan ini saya mulai memakai gemtext(.gmi) milik Gemini alih-alih Markdown
    Fiturnya sedikit, tetapi sederhana dan mudah di-parse. Tautan diawali dengan =>, dan pemisahan paragraf juga jelas
    Parser saya hanya sekitar 70 baris, tetapi mencakup 95% fungsi Markdown
    • Saya juga suka gemtext. Header dan tautan sederhana saja sudah cukup
      Hanya saja, memproses line break sebagai pemisah paragraf terasa kurang nyaman.
      Menurut saya lebih baik memakai baris kosong ganda sebagai pemisah paragraf seperti di Pandoc Markdown
  • Keunggulan terbesar org-mode adalah fitur makro
    Saya menulis materi ajar online dalam org-mode, lalu mengekspornya ke HTML setiap semester
    Saya mengotomatiskan perluasan teks, evaluasi elisp, dan lain-lain dengan makro
    Misalnya, {{{NOUN-C}}} berubah menjadi “Clause” atau “Rule” tergantung konteks
    Tanggal di bagian atas halaman juga dibuat otomatis dengan elisp.
    Saya memakai hosting site44.com yang terintegrasi dengan Dropbox, jadi begitu disimpan, perubahan langsung tampil di web
  • org-mode masih belum punya spesifikasi resmi (spec)
    Karena itu, hampir tidak ada alat lain yang mendukungnya. Sebaliknya, CommonMark sudah distandardisasi
    Saya akan tetap memakai CommonMark
    • Ketiadaan spesifikasi bukan berarti membuat org tertahan. Markdown juga sukses berkat kesederhanaan dan integrasi
      Fakta bahwa situs seperti Reddit mengadopsi Markdown justru merupakan keputusan yang bagus
    • Dokumen org-syntax berfungsi sebagai semacam spesifikasi tidak resmi
    • Python juga tidak punya spesifikasi, tetapi CPython adalah standar de facto. Situasinya mirip
    • Ada banyak aplikasi yang mendukung org. Aplikasi mobile, plugin Vim, GitHub, Codeberg juga mendukungnya
      Dibanding Markdown, ada lebih banyak solusi open source yang kuat untuk sinkronisasi lokal
      Aplikasi catatan berbasis Markdown justru cenderung bergantung pada cloud
    • Codeberg juga mendukung org di README. Beberapa Git forge lain juga mendukungnya