Org Mode sözdizimi, metin için en mantıklı biçimlendirme dillerinden biri (2017)

 (karl-voit.at)
3 puan yazan GN⁺ 2026-01-12 | 1 yorum | WhatsApp'ta paylaş
  • Org Mode sözdizimi, Emacs dışında da kullanılabilen sezgisel ve tutarlı bir hafif biçimlendirme dili olarak sunuluyor
  • Başlıklar, listeler, biçimlendirme, bağlantılar gibi temel sözdizimi basit ve hatırlaması kolay bir yapıya sahip; ayrıca diğer dillere göre ifade tutarlılığı daha yüksek
  • Markdown’ın çeşitli türev sürümlerinden farklı olarak Org Mode, tek bir uygulamayı (Emacs Org-mode) merkez alarak görece standartlaşmış bir biçimi koruyor
  • Pandoc gibi çeşitli araçlarla dönüştürülebiliyor ve Emacs kullanmadan da sıradan metin düzenleyicilerinde kolayca yazılabiliyor
  • Hafif biçimlendirme dilleri arasında okunabilirlik, bakım kolaylığı ve araç desteği açısından güçlü olduğu için, düz metin tabanlı belge yazımı için bir alternatif olarak vurgulanıyor

Org Mode sözdizimine genel bakış

  • Org Mode sözdizimi Emacs’e bağımlı değil; vim, Atom, Notepad vb. tüm metin düzenleyicilerinde kullanılabiliyor
    • Başlıklar, hiyerarşiyi *, **, ** * ile ifade ediyor
    • Metin biçimlendirmesi *bold*, /italic/, _underlined_, +strikethrough+, =monospaced= biçiminde
    • Bağlantılar [[URL][açıklama]] biçimiyle sade
    • Listeler (-, 1.), onay kutuları ([ ], [X]), kod blokları (#+BEGIN_SRC ... #+END_SRC) da destekleniyor
  • Tablolarda elle hizalama zor olabiliyor, ancak hizalama göz ardı edilse bile sözdizimi tanınabiliyor
  • Kullanıcılar ayrı bir kopya kağıdı olmadan da sözdizimini doğal şekilde öğrenebiliyor

Standartlaşma ve Markdown’ın sorunları

  • Markdown’da çok sayıda türev standart (Original, Extra, MultiMarkdown, GitHub Flavored, CommonMark vb.) bulunduğu için uyumluluk sorunları ortaya çıkıyor
    • Aynı “Markdown” bile araçtan araca farklı sözdizimine sahip olabildiğinden veri kaybına ve kullanılabilirlik düşüşüne yol açıyor
  • Org Mode’da ise tüm sözdizimi tek bir Emacs Org-mode uygulamasına göre tanımlandığı için tutarlı yorumlama mümkün
    • Türev araçlar, özgünün alt kümesi (subset) olarak çalışıyor
    • Dosya uzantısı her zaman .org olarak birleştiriliyor
  • Resmî bir standart belgesi olmasa da Emacs uygulaması fiilî standart (golden standard) işlevi görüyor

Tutarlılık ve kullanılabilirlik karşılaştırması

  • Başlık sözdizimi: Org Mode, yalnızca * önekiyle hiyerarşiyi basitçe ifade ediyor
    • Markdown, AsciiDoc, reStructuredText gibi diller ise önek-son ek ya da alt çizgi yöntemi gibi karmaşık ve tutarsız yapılara sahip
    • Bazı dillerin karma stillere izin vermesi de kafa karışıklığını artırıyor
  • Bağlantı sözdizimi: Org Mode’daki [[URL][metin]] sade olsa da,
    • Markdown’daki [metin](URL) veya reStructuredText’teki `metin <URL>`_ gibi biçimler sembol kombinasyonları açısından daha karmaşık ve daha az tutarlı
  • Biçimlendirme sözdizimi: Org Mode, /italic/, *bold*, ~monospace~, +strikethrough+ ile tutarlı bir çift sembol yapısı sunuyor
    • Markdown ise _italic_, **bold**, ~~strike~~ gibi sembol sayısı ve kuralları bakımından dengesiz

Girdi kolaylığı ve araç bağımsızlığı

  • Org Mode’da gereksiz karakter girişi az ve elle hizalama ya da karmaşık sözdizimi gerekmiyor
  • Emacs dışında da Org Mode sözdizimiyle yazılmış metinler Pandoc üzerinden HTML, PDF, Word gibi çeşitli biçimlere dönüştürülebiliyor
  • GitHub, GitLab da Org dosyalarını işleyebiliyor; bu nedenle basit metin düzenleme ortamlarında da verimli
  • Özellikle “araç desteğinin olmadığı ortamlarda Org Mode sözdizimi daha kullanışlıdır” vurgusu yapılıyor

Emacs içindeki araç desteği

  • Emacs’te Org Mode ile yazarken TAB, Alt+ok tuşları, Ctrl+Return gibi kısayollarla yapı üzerinde işlem yapılabiliyor
    • Başlıkları katlama/açma, listeleri taşıma, tablo satır ve sütunlarını hareket ettirme gibi otomasyonlar destekleniyor
  • Menü tabanlı kullanım da mümkün; kısayolları öğrenmeden de verimli yazım sağlanabiliyor
  • Emacs kullanmak şart değil, ancak kullanıldığında en güçlü biçimlendirme düzenleme deneyimini sunduğu belirtiliyor
  • Markdown, AsciiDoc, reStructuredText gibi seçeneklerde benzer düzeyde bir araç desteği bulunmadığı ifade ediliyor

Sonuç ve Orgdown önerisi

  • Hafif biçimlendirme dillerinin amacı sadelik ve verimlilik; Org Mode da bu açıdan en mantıklı tasarımlardan biri olarak görülüyor
  • Markdown, AsciiDoc, reStructuredText gibi diller tutarlılık eksikliği ve karmaşık sözdizimi nedeniyle kullanım açısından geride kalıyor
  • Org Mode’un öğrenme eğrisi düşük, araçtan bağımsız ve dönüştürme uyumluluğu yüksek olduğu belirtiliyor
  • 2021 sonrasında bu tartışmalardan gelişerek Orgdown adlı yeni bir standartlaşma girişimi ortaya çıktı
    • Org Mode sözdizimini temel alan bağımsız bir hafif biçimlendirme standardizasyon projesi olarak tanıtılıyor

Ek tartışmalar ve geri bildirimler

  • Bazı kullanıcılar Org Mode’un resmî bir standarda sahip olmamasını eleştiriyor
    • Emacs ile Pandoc arasında yorum farkları bulunsa da Emacs uygulaması fiilî ölçüt olarak kabul ediliyor
  • reStructuredText’in bağlantı referansı özelliklerine dair geri bildirimler de vardı, ancak
    • yazar yine de Org Mode’u en mantıklı ve hatırlaması en kolay hafif biçimlendirme dili olarak değerlendiriyor
  • Sonuç olarak Org Mode, Emacs ekosisteminin ötesinde düz metin belge yazımı için mantıklı bir alternatif olarak sunuluyor

İlgili okumalar

1 yorum

 
GN⁺ 2026-01-12
Hacker News yorumları
  • 2016'da Evernote'tan org-mode'a geçerken Emacs kullanmaya başladım
    Şimdi tüm projelerim, görevlerim ve bilgi yönetimim için org-mode kullanıyorum. Bazı dosyalar 15MB'ı geçiyor
    Başta sadece basit başlıkları kullanıyordum, ama ihtiyaç duydukça gereken özelliklerin zaten hazır olduğunu gördüm. Hem kullanımı kolay hem de güçlü genişletilebilirlik sunan araçlar nadirdir diye düşünüyorum
    • PDF, görsel, HTML gibi zengin metin içeriklerini nasıl ele aldığını merak ediyorum. Evernote bunu iyi desteklediği için hâlâ ayrılamıyorum
    • Ben de birkaç yıldır org-mode kullanıyorum ama sadece temel başlıklar, biçimlendirme, bağlantılar ve kod bloklarıyla sınırlı kaldım
      Daha derin öğrenmeye değer ileri düzey özellikler varsa öneri duymak isterim
    • 15MB yaklaşık 3 milyon kelime ediyor olmalı. Neredeyse 60 romanlık bir hacim, gerçekten şaşırtıcı
  • org biçimi kendi başına sezgisel ama asıl gücü Emacs ile entegrasyonundan geliyor
    Kişisel bilgi yönetimi (PIM), belge yazımı, notlar, otomatik kısayollar gibi amaçlarla kullanılabiliyor
    Sadece Markdown'a alternatif bir biçim olarak kullanmaktan ziyade Emacs ekosisteminin içinde parlıyor
    • org biçimi Emacs dışında da Markdown kadar yaygın benimsenirse değerinin daha da artacağını düşünüyorum
      Karl Voit'in yazısı, org sözdiziminin Markdown'dan daha tutarlı ve daha özlü olduğunu savunuyor
      Teknoloji dünyasında daha iyi biçimler her zaman kazanmasa da, bunu savunmaya devam etmeye değer buluyorum
    • Ben de her gün Markdown kullanıyorum ama pratikte orgdown'ın daha kullanışlı olduğunu hissediyorum
      İlgili yazı da bunu vurguluyordu
  • Tüm kitaplarımı Markdown ile yazıyorum
    Eskiden XML kullanıyordum ama çok zahmetli olduğu için değiştirdim. Pandoc tabanlı bir iş akışıyla HTML ve PDF üretiyorum
    Son zamanlarda Typst ile PDF'leri daha hızlı oluşturuyorum.
    xml2typ projesini yapıp Pandoc/LaTeX'e göre çok daha hızlı PDF üretmeye başladım
    • Typst ile doğrudan PDF üretmek mümkünken neden ayrıca docbook ve xsltproc üzerinden geçtiğini merak ediyorum
    • Depoya baktım, test.md için son PDF çıktısı da eklenirse güzel olurdu
  • Uzun zamandır org'ı üretkenlik araçları arasında değişim biçimi olarak öneriyorum
    org; yer imlerini, PKM'yi ve yapılacaklar yönetimini birleştirebilir
    Ama yapay zeka çağında LLM eğitimi için Markdown varsayılan biçim haline geliyor
    Yine de LLM'ler org'ı da iyi işliyor, bu yüzden ikisinin bir arada yaşaması mümkün
    İlgili öneri yazısına bakabilirsiniz
    • Benim yazımın odağı org-mode'un sözdizimi (orgdown). Sharepoint ya da Jira gibi araçlardan söz etmek ayrı bir konu
    • Bence ConnectedText hâlâ org'dan arama kabiliyeti ve kararlılık açısından daha iyiydi
      Açık kaynak olmaması üzücü. Tek geliştiricili projelerin SPOF sorununu gösteriyor
    • Benim deneyimime göre LLM'ler de org-mode'u iyi işliyor. İnternette eğitim için yeterince org verisi var
  • 10 yıldır org-mode ile hayatımı yönetiyorum
    iOS için Beorg sayesinde mobilde de rahat kullanıyorum
    org-ql ve org-super-agenda ile üretkenliğimi artırdım
    Her gün iş günlüğümü org dosyaları olarak tutuyorum; yıl sonu değerlendirmelerinde çok faydasını görüyorum
    • Tarayıcı eklentim BrainTool'u öneririm
      Yer imleri ve sekmeleri org dosyalarıyla senkronize edip TODO olarak yönetebiliyorsunuz
    • Ben de günlük yapısını düşünüyorum. Tarih merkezli yerine bağlam merkezli başlıkları tercih ediyorum
      Dosyalar arası bağlantıları nasıl kurduğunu merak ediyorum. denote'u da değerlendiriyorum
  • Karmaşık HTML ya da LaTeX'i org-mode ile ifade etmenin aslında daha zor olduğunu düşünüyorum
    Bu yüzden karmaşık şeylerde doğrudan HTML veya LaTeX kaynağını yazıyorum
    org-mode programı harika ama sadece sözdizimine bakarsak Markdown daha pratik
    Blogumu org'dan Markdown'a taşırken kod daha sade oldu ve hız da 50 kat arttı
    • Ben ise tersine Markdown'dan org'a geçtim
      shite projesiyle Bash tabanlı bir site üreticisi yaptım ve org içine doğrudan HTML blokları gömdüm
      Sadece HTML düzenlemeyi sağlayan org-edit-special özelliği çok kullanışlıydı
    • Kod blokları (#+BEGIN_SRC html) kullanırsan dile özel renklendirme de mümkün
      yasnippet ile kısayol tanımlamak da kullanışlı oluyor
    • org içinde HTML/LaTeX kolayca eklenebiliyor
      2009'dan beri tüm Beamer belgelerimi org ile yazıyorum
      Pelican bloguna da Python eklentisiyle org desteği eklemiştim
    • Ben de blogumu org'dan Markdown'a taşıdım
      org harika bir fikir ama sorun uyumluluk eksikliği. Markdown her yerde desteklendiği için daha gerçekçi bir tercih
  • Markdown zaten standart hafif sıklet işaretleme dili haline geldi
    org-mode ne kadar mantıklı olursa olsun, yaygınlığı olan Markdown'ı varsayılan olarak kullanmak daha gerçekçi
    • Markdown'ı isim, Org-mode'u ise fiil (sistem) olarak düşünmek gerekir
      Bu basit bir biçim karşılaştırması değil, tamamen farklı çalışma biçimlerine sahip araçlar
      Markdown sadece yapı sunarken, Org durum ve çalıştırma mantığını da içeriyor
      Bu yüzden “varsayılan seçim” tartışması anlamsız. Herkes amacına göre kullanmalı
    • Kişisel dosya biçimlerini popülerliğe göre mi belirlememiz gerekiyor?
      org-mode kullanan birine bırakmasını söylemek için bir neden yok
    • Sonuçta bu bir zevk meselesi. LaTeX vs Typst gibi, insan kendine uygun ortamı seçmeli
    • Markdown'ın düz metin halinde daha okunaklı olduğunu düşünüyorum
      org'daki yıldızlı başlıklar görsel olarak daha karmaşık. Yine de italik gösterimini seviyorum
    • Markdown'da çok fazla belirsizlik ve uyumluluk sorunu var
      Gerçeklemeye göre değişiyor; tablo ve dipnot gibi özellikler de ayrı uzantılar halinde geliyor
      Tek gerçek avantajı evrenselliği
  • Son zamanlarda Markdown yerine Gemini'nin gemtext(.gmi) biçimini kullanmaya başladım
    Özelliği az ama basit ve ayrıştırması kolay. Bağlantılar => ile başlıyor ve paragraf ayrımı da net
    Yazdığım ayrıştırıcı yaklaşık 70 satır ve Markdown'un işlevlerinin %95'ini kapsıyor
    • Ben de gemtext'i seviyorum. Basit başlıklar ve bağlantılar çoğu zaman yeterli
      Ama satır sonlarını paragraf ayrımı olarak kullanması rahatsız edici
      Pandoc Markdown'daki gibi çift satır sonunu paragraf ayrımı yapmak daha iyi olurdu
  • org-mode'un en büyük avantajı makro özelliği
    Çevrimiçi ders materyallerimi org-mode ile yazıyor ve her dönem HTML olarak dışa aktarıyorum
    Makrolarla metin genişletme, elisp değerlendirme gibi işleri otomatikleştiriyorum
    Örneğin {{{NOUN-C}}}, duruma göre “Clause” ya da “Rule” olarak değişiyor
    Sayfanın üstündeki tarih de elisp ile otomatik oluşturuluyor.
    Dropbox ile entegre çalışan site44.com barındırmasını kullandığım için kaydeder kaydetmez web'e yansıyor
  • org-mode için hâlâ resmî bir spec yok
    Bu yüzden başka araçlar neredeyse hiç desteklemiyor. Buna karşılık CommonMark standartlaştırılmış durumda
    Ben CommonMark kullanmaya devam edeceğim
    • Spec eksikliği org'ın önünü kesen şey değil. Markdown da sadeliği ve bütünleşebilirliği sayesinde başarılı oldu
      Reddit gibi sitelerin Markdown benimsemesi aslında iyi bir tercihti
    • org-syntax belgesi bir tür gayriresmî spec işlevi görüyor
    • Python'un da resmî bir spec'i yok ama CPython fiilî standart. Benzer bir durum var
    • org'ı destekleyen çok sayıda uygulama var. Mobil uygulamalar, Vim eklentileri, GitHub, Codeberg gibi yerlerde de destekleniyor
      Markdown'a göre yerel senkronizasyon tarafında daha güçlü açık kaynak çözümler var
      Markdown tabanlı not uygulamaları ise daha çok buluta bağımlı
    • Codeberg de README içinde org'ı destekliyor. Başka Git forge'larda da kısmi destek var