Quarkdown - Güçlü özelliklerle zenginleştirilmiş Markdown

 (quarkdown.com)
2 puan yazan GN⁺ 1 일 전 | 1 yorum | WhatsApp'ta paylaş
  • Markdown tabanlı belge yazımını, LaTeX düzeyinde dizgi özellikleriyle birleştirerek makalelerden kitaplara, sunumlardan statik sitelere ve bilgi tabanlarına kadar her şeyi tek bir araçla ele alacak şekilde tasarlanmış
  • Boilerplate'i azaltan söz dizimi içinde yazar, kenar boşluğu, özet, görsel ve alıntı gibi öğeler doğrudan yer alabiliyor; böylece içerik ve düzen birlikte yazılabiliyor
  • Tek satırlık .doctype ayarıyla paged, plain, docs, slides belge türleri arasında geçiş yapılabiliyor ve interaktif sunumlar da destekleniyor
  • Hızlı derleme ve canlı önizleme sunuyor; ayrıca Turing complete betikleme ile işlev ve argümanların yeniden kullanılması sayesinde tekrarlayan düzen işlerini azaltabiliyor
  • Ücretsiz açık kaynak olarak sunuluyor; GitHub'da 10K'dan fazla yıldız, VS Code entegrasyonu, Quickstart ve dokümantasyon kaynaklarıyla gerçek kullanım ve genişletme yollarını güçlendiriyor

Temel özellikler

  • Markdown ile LaTeX düzeyinde dizgi özelliklerini birleştiren modern bir belge yazım sistemi
  • Makaleler, kitaplar, sunumlar, statik siteler ve bilgi tabanları tek bir araçla yönetilebiliyor
  • Ücretsiz ve açık kaynak olarak sunuluyor; derleyicisi gelişmeye devam ediyor ve özgür yazılım olarak korunuyor
  • Quarkdown, Wiki, Discuss

Yazım deneyimi

  • Boilerplate olmadan yazmaya odaklanılabilmesi için tasarlanmış
  • docauthor, pagemargin, abstract, görseller ve alıntılar gibi öğeler doğrudan söz dizimi içine yerleştirilebiliyor; böylece belge düzeni ve içerik birlikte ele alınabiliyor
  • Örnek belge; başlık, yazar, kenar boşluğu, görsel, özet ve alıntının tek bir dosyada birlikte yazıldığı bir akışla oluşturuluyor
  • Genişletilmiş söz dizimi sayesinde temel Markdown'dan daha fazla ifade gücü sunuyor

Belge türleri ve doctype

  • Belge türleri tek satırlık .doctype ayarıyla değiştiriliyor
  • paged, makale, kitap ve raporlar için kullanılıyor
  • plain, notlar, bilgi tabanları ve basit statik web siteleri için kullanılıyor
  • docs, wiki'ler, teknik dokümantasyon ve büyük bilgi tabanları için kullanılıyor
  • slides, dersler, sunumlar ve interaktif sunumlar için kullanılıyor

Duyarlı önizleme ve betikleme

  • Hızlı derleme ve canlı önizleme sayesinde yazarken sonucu anında görmek mümkün
  • Tekrarlayan işleri azaltmak için Turing complete betikleme özelliği içeriyor
  • İşlev tanımları ve argümanların yeniden kullanımıyla aynı düzen kalıpları birden fazla öğeye uygulanabiliyor
  • Örnekte animal işlevi tanımlandıktan sonra ad, ekosistem ve görsel düzeni yeniden kullanılarak birden fazla öğe oluşturuluyor

Kurulum ve başlangıç yolu

Ekosistem ve kaynaklar

  • GitHub'da 10K'dan fazla yıldıza ulaştığı belirtiliyor
  • Quickstart, Docs, VS Code, Wiki üzerinden öğrenme ve editör entegrasyonu yolları sunuluyor

İlgili okumalar

1 yorum

 
GN⁺ 1 일 전
Hacker News görüşleri

  • Dürüst olmak gerekirse etkileyici, ama benim için Markdown'ın özü aşırı derecede basit olması
    GUI olmadan da düzenlenebiliyor, terminalde VIM ile yazarken bile sonucun aşağı yukarı nasıl görüneceğini tahmin edebiliyorsun ve ham .md dosyasının kendisi de zaten rahat okunuyor
    Ama bunun üstüne sürekli özellik eklemeye başlayınca insan durmadan bilmediği komutları arıyor, sonunda da ne akılda kalıyor ne de render almadan nasıl görüneceğinden emin olunuyor; insan WYSIWYG editörü istemeye başlıyor
    Bu bana QWERTY klavyeye Kiril, Devanagari, Çince ve Arapça tuşlarını da ekleyelim demeye benziyor; sonuçta yine hunt and peck yazmaya dönmüş gibi oluyorsun

    • Benim için Markdown'ın en büyük artılarından biri yarı WYSIWYG olması
      Temel sözdizimi, insanların zaten metinde biçimlendirmeyi taklit etmek için kullandığı yöntemleri yeniden kullanıyor; bu yüzden giriş metni çoğunlukla olduğu gibi okunabilir kalıyor
      Markdown yazımını tam olarak bilmesen bile genelde okumakta sorun yaşamıyorsun; tablolar tablo gibi, paragraflar da paragraf gibi görünüyor
      Arada bir sözdizimine tekrar bakıyorum ama bunda sorun yok. Pasif dağarcığın aktif dağarcığından büyük olması gayet doğal
      O yüzden ben daha çok kaynak metnin okunabilirliğine göre değerlendiriyorum ve burada gösterilenlerin önemli bir kısmı bu ölçüte göre çok net bir kazanç sunmuyor gibi
      Yine de denklem biçimlendirme örneği görmedim; LaTeX kullandığım ender durumların çoğu da zaten Markdown'ın karşılamadığı matematik ifadeleri yüzünden, o kısmın pratikte nasıl göründüğünü merak ediyorum
    • Bu epey ikna edici bir argüman
      Yine de Quarkdown, LaTeX'i doğrudan yazmaktan açıkça daha üst düzey görünüyor; Word gibi GUI editörlerine kıyasla da sonuçların öngörülebilirliği ve LLM destekli düzenleme uyumluluğu daha iyi duruyor
    • Garip yeni komutlar ezberletmeyen ve üstüne pürüzsüz bir UI/UX sunan, daha süper güçlü bir Quarkdown yapmak lazım
      Adı da Microsoft Word olur
    • Ben de küçük bir Markdown renderer yapıyorum; isim koyması bile zor, bitse bile insanlara kullandırmak daha da zor
      Bugünlerde sıradan bir "plain markdown" editörüyle dikkat çekmek zor; HN ana sayfasına çıkmak için sonunda normal Markdown'ı aşan bir işlevsellik ve olgunluk gerekiyor gibi görünüyor
      Bir çeşit doğal seçilim gibi hissettiriyor
    • Obsidian.md, temel Markdown için gerçekten harika bir WYSIWYG editörü

  • Bu araçları ve işaretleme dillerini tek seferde karşılaştıran bir kaynak olsa güzel olurdu
    MyST, Pandoc, Quarkdown, Quarto, Typst yan yana görülse iyi olur
    Quarto ve Pandoc, Pandoc Markdown kullanıyor; https://www.zettlr.com/ da öyle
    Buna karşılık Quarkdown ve Typst, LaTeX ya da HTML+Javascript tarafına daha yakın duran programlanabilir işaretleme dili gibi hissettiriyor; bu yüzden hangisinin gerçek LaTeX halefi olacağı hâlâ net değil gibi

    • Çoğunu bizzat kullandım ve kullanmaya da devam etmeyi düşünüyorum; kabaca şöyle ayırabiliriz
      Markdown, .txt üzerine biraz sözdizimsel şeker serpilmiş ve PDF ya da HTML'e aktarılabilen bir şey
      Quarto, kod bloklarını çalıştırmak istediğin Markdown
      Typst ise modernleştirilmiş LaTeX gibi; ıvır zıvırın %90'ı gitmiş ama özelliklerin de yaklaşık %10'u eksilmiş gibi
      Akademi zaten yeni şeyleri sevmez; bu yüzden Typst kullansan bile çok hoş karşılamayabilirler
      Pandoc ise sonuçta PDF, HTML gibi çeşitli biçimlere dışa aktarma aracı
      Genelde hangi tarafa ait bir araca ihtiyaç duyduğun çabuk anlaşılıyor; asciidoc gibi şeyler de var ama markdown/quarto/typst kombinasyonunun kapsamadığı ne kalıyor diye düşününce çok fazla bir şey çıkmıyor
      Geriye kalsa kalsa WYSIWYG editörleri kalıyor
    • Karşılaştırma listesine djot da eklenebilir
      İyi tasarlanmış ve epey kapsamlı bir Markdown superset'i gibi görünüyor
      https://djot.net/
    • Typst'i gerçekten sevmek istedim
      LaTeX kullanmamak harika olurdu ama gerçek projelerde deneyince köşe durumları çok fazlaydı; sonunda yine LaTeX'e döndüm
      LaTeX'te olup eksik kalan şeyler de var ve Pandoc dönüştürülebilirliğinin zayıf olması da önemliydi
      Keşke o son %10 da tamamlansa
    • Eğer kastedilen böyle bir karşılaştırmaysa, zaten var
      https://github.com/iamgio/quarkdown#comparison
    • Pandoc diğer araçlarla aynı katmanda değil
      Ara JSON formatı üzerinde istediğin filtreleri çalıştırabildiğin için, istediğin dönüşümü pratikte neredeyse tamamen gerçekleştirebilirsin; ayrıca çeşitli formatları bu JSON'a ya da tersine dönüştürüyor
      Bu yüzden ben Pandoc tabanlı sistemleri tercih ediyorum; temel aracın yapamadığı işler bile çoğu zaman basit bir inline filter ile çözülebiliyor

  • Fizik yazılımının standart modeline göre Quarkdown, Atom'da düzenlenirse Quarkup olur ve Neutron Mail'in de Proton Mail'e çevrilmesi gerekir
    Tabii bunun çalışması için Electron uygulamasını sol elle yazarken bir de anti-Neutrinos AI blogpost kaleme alman gerekiyor

  • Kısa değerlendirmem şu: bu aslında LaTeX tarzı makrolar eklenmiş Markdown'a oldukça yakın
    Sadece burada buna fonksiyon deniyor; muhtemelen de en az bir yan etkili fonksiyon olduğu için: yeni fonksiyon tanımlayan fonksiyon
    "Her şey fonksiyondur" türü sözdizimsel saflığı seviyorum ama yapı ve stillendirmeyi HTML/CSS tarzında doğal biçimde birbirine karıştırması biraz karışık hissettiriyor. Gerçi o sınır zaten baştan beri pek net değildi
    Yine de oldukça havalı ve Markdown'ı büyük ölçüde değiştirmeye çalışan girişimlere şüpheyle yaklaşılmasını da anlıyorum
    Fonksiyonların aşırı kullanımının kaynak metnin okunabilirliğini düşürebileceği eleştirisi doğru; bazen Turing-tam olmama da bir avantaj olabiliyor
    Ama Markdown'a fonksiyon ekleyen bir tasarım olarak bakarsak, bence bu oldukça temiz bir tasarım

  • Ben Quarkdown'ın yazarı ve proje lideriyim
    İlk başta bir üniversite araştırma projesi olarak başlamıştı; iki yıl sonra böyle bir şeye dönüşeceğini hiç düşünmemiştim
    İlgi gösterdiğiniz için teşekkürler, yorumlara elimden geldiğince cevap vermeye çalışacağım

    • v3'te kalın yazı sözdizimini "düzeltmeyi" düşünüyor musunuz merak ediyorum
      Ben hep **bold** ve *italic* yerine *bold* ve _italic_ kullanmanın daha mantıklı olduğunu düşünmüşümdür
      Markdown'daki o fazladan yıldız pek iyi bir tasarım değil ve özellikle telefonda ya da tablette Markdown düzenlerken oldukça rahatsız edici
    • Bir metin formatına fonksiyon koyma fikri bana epey yabancı geliyor
      GUI belgelerde bile makrolardan genelde kaçınılır; Quarkdown en başından beri karmaşık ve tekrarlı belgeler için mi tasarlandı diye merak ediyorum
      Soruları kabul ettiğiniz için teşekkürler
    • https://iamgio.eu/2025-12-10-accidentally-in-silicon-valley/ yazısını okudum; işlerin yolunda gitmiş gibi görünmesine sevindim

  • Belgeleri hızlıca gözden geçirince değerlendirme modelinin bu işe uygun olup olmadığı konusunda biraz endişelendim
    Metin yerleşiminde genelde bir kısmı değiştirince diğer kısımların dizilimi bozulur ve yeniden yerleşim geçişi gerekir; bu yüzden sabit noktaya kadar yineleme yapan bir yapıya ihtiyaç olur
    Typst bunun için context kavramını kullanıyor https://typst.app/docs/reference/context/, ama Quarkdown'da benzer bir şey görmedim. Gözümden kaçmış olabilir
    Kitap çalışmalarımda pandoc/md/LaTeX kombinasyonundan Typst'e geçtim ve oldukça memnunum
    Modern bir dille program yazıyormuş hissi veriyor ve hızı da pandoc+LaTeX'ten çok daha iyi
    https://functionalprogrammingstrategies.com/

  • AsciiDoc tarafının gözünden bakınca Quarkdown'ın sözdizimi tasarımı temiz görünüyor; özellikle de kullanıcı tanımlı fonksiyonlar iyi duruyor
    Ama bu kategoride daha zor olanın kaynak dilin kendisinden çok çıktı hattı olduğunu düşünüyorum
    Çapraz referanslar, admonition'lar, koşullu içerik, fonksiyon tabanlı yeniden kullanım gibi Markdown genişletmeleri tasarım düzeyinde yeterince ele alınabilir
    Asıl duvar bundan sonra geliyor; örneğin PDF/UA uyumlu tagged PDF, ortamdan bağımsız sallanmayan deterministic build, çok dilli belge sitelerinde hreflang ve belgeler arası bağlama, 500 sayfalık kitaplarda bile dayanan incremental rebuild gibi şeyler
    Özellikle AB'de 28 Haziran 2025'te European Accessibility Act yürürlüğe girdikten sonra PDF/UA daha da önemli hâle geldi
    Dört doctype'ı, özellikle de paged tarafını nasıl ele almayı planladığınızı merak ediyorum

  • Karşılaştırma tablosunda MyST de olmalı
    https://mystmd.org/
    Bu taraf ileride yeni Markdown standardı hâline gelebilir gibi görünüyor

    • Ya da Typst de eklenebilir
      Markdown uzantısı değil ama hedefleri ve kullanım senaryoları epey benziyor
    • MyST + Sphinx kombinasyonu çok iyi
      Ama güçlü LSP desteği eksikliği üzücü; en azından ben helix üzerinde bunu düzgün çalıştırmayı başaramadım
      Blogumu da pydata-sphinx-theme ve myst ile yaptım
    • O tarafı pek bilmiyorum
      İstersen tabloyu bir PR ile kendin güncelleyebilirsin

  • Ben uygulamamda biraz farklı bir yaklaşım seçtim
    Okunabilirliğe ve büyük Mermaid diyagramlarıyla çalışmayı kolaylaştırmaya odaklandım; yakın zamanda da harita gibi gezilen bir tam ekran modu ekledim
    https://mdview.io/s/97af684b

  • SSG kullanırken girdiyi mümkün olduğunca temiz Markdown olarak bırakmayı, biçim ayrıntılarını da CSS tarafına taşımayı tercih ediyorum
    Mesela .abstract gibi bir şeyi özellikle yazmak yerine, CSS ilk paragrafı abstract gibi ele alabilir
    Buna karşılık bu proje daha zengin, kendi kendine yeten belgeler üretme yönünde görünüyor
    CSS yok ama önceden tanımlı çok sayıda stillendirme seçeneği var; bu yüzden aklıma sürekli ilk dönem HTML geliyor
    HTML 1, renk bile olmayan ve neredeyse hiç biçimlendirme içermeyen yapısıyla Markdown'a benziyordu; HTML 3 civarında ise içine bir sürü şey girmeye başladı, bu da o akışı andırıyor