Quarkdown - उन्नत क्षमताओं वाला Markdown

• Markdown-आधारित दस्तावेज़ लेखन में LaTeX-स्तर की typesetting क्षमताएँ जोड़कर इसे इस तरह बनाया गया है कि research paper से लेकर किताब, presentation, static site और knowledge base तक सब कुछ एक ही टूल में संभाला जा सके
• कम boilerplate वाली syntax के भीतर author, margin, abstract, image और quote जैसे elements सीधे शामिल किए जा सकते हैं, जिससे content और layout को साथ में लिखा जा सकता है
• एक पंक्ति की .doctype सेटिंग से paged, plain, docs, slides document types के बीच स्विच किया जा सकता है, और interactive presentation भी समर्थित है
• तेज़ compile और live preview उपलब्ध है, और Turing complete scripting के ज़रिए function और arguments के reuse से दोहराए जाने वाले layout काम कम किए जा सकते हैं
• यह मुफ़्त open source के रूप में उपलब्ध है, GitHub पर 10K से अधिक stars, VS Code integration, Quickstart और documentation resources के साथ, जिससे practical use और विस्तार के रास्ते बढ़ते हैं

---

मुख्य विशेषताएँ

• Markdown में LaTeX-स्तर की typesetting क्षमताएँ जोड़ने वाला एक आधुनिक document authoring system
• research paper, किताब, presentation, static site और knowledge base तक को एक ही टूल में संभालने के लिए बनाया गया है
• यह मुफ़्त open source के रूप में उपलब्ध है, compiler लगातार विकसित हो रहा है और free software के रूप में बनाए रखा गया है
• Quarkdown, Wiki, Discuss

लेखन अनुभव

• इसे boilerplate के बिना लेखन पर ध्यान केंद्रित करने के लिए डिज़ाइन किया गया है
• docauthor, pagemargin, abstract, image और quote जैसे elements को syntax के भीतर सीधे रखा जा सकता है, जिससे document layout और main content को साथ में संभाला जा सकता है
• example document इस flow में बना है कि title, author, margin, image, abstract और quote को एक ही फ़ाइल में साथ लिखा जाए
• extended syntax के ज़रिए basic Markdown की तुलना में अधिक अभिव्यक्ति संभव है

document types और doctype

• document type को एक पंक्ति की .doctype सेटिंग से बदला जा सकता है
• paged का उपयोग article, किताब और report के लिए होता है
• plain का उपयोग notes, knowledge base और साधारण static website के लिए होता है
• docs का उपयोग wiki, technical documentation और बड़े knowledge base के लिए होता है
• slides का उपयोग lecture, presentation और interactive presentation के लिए होता है

responsive preview और scripting

• तेज़ compile और live preview के ज़रिए टाइप करते समय तुरंत परिणाम देखा जा सकता है
• दोहराए जाने वाले काम कम करने के लिए Turing complete scripting feature शामिल है
• function definition और arguments के reuse से एक ही layout pattern को कई items पर लागू किया जा सकता है
• उदाहरण में animal function define करने के बाद name, ecosystem और illustration composition को reuse करके कई items बनाए जाते हैं

installation और शुरुआत का रास्ता

• installation section में v2.0.0 को 23 अप्रैल 2026 को जारी दिखाया गया है
• Linux / macOS: curl -fsSL https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/… | sudo env "PATH=$PATH" bash
• macOS Homebrew: brew install quarkdown-labs/quarkdown/quarkdown
• Windows: irm https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/… | iex
• Windows Scoop
  • scoop bucket add java
  • scoop bucket add quarkdown https://github.com/quarkdown-labs/scoop-quarkdown
  • scoop install quarkdown
• Explore
• Get started →

ecosystem और resources

• GitHub पर 10K से अधिक stars हासिल किए हुए दिखाए गए हैं
• Quickstart, Docs, VS Code, Wiki के ज़रिए learning और editor integration के रास्ते उपलब्ध कराए गए हैं

[GN⁺]

Hacker News की राय

• सच कहूँ तो यह प्रभावशाली है, लेकिन मेरे लिए Markdown का मूल सार इसकी बेहद सादगी में है
  इसे GUI के बिना भी एडिट किया जा सकता है, टर्मिनल में VIM पर लिखते समय भी अंदाज़ा रहता है कि नतीजा लगभग कैसा दिखेगा, और raw .md फ़ाइल खुद भी वैसे ही पढ़ने लायक होती है
  लेकिन जब इसमें लगातार फीचर जोड़ने शुरू करते हैं, तो बार-बार अनजान कमांड ढूँढने पड़ते हैं, फिर वे याद भी नहीं रहते, और rendering के बिना यह भरोसा भी नहीं रहता कि चीज़ कैसी दिखेगी, तो आखिरकार WYSIWYG एडिटर की इच्छा होने लगती है
  यह कुछ वैसा लगता है जैसे QWERTY कीबोर्ड में Cyrillic, Devanagari, Chinese और Arabic कीज़ भी सब जोड़ देने की सोच हो, और फिर अंत में दोबारा hunt and peck पर लौटना पड़े

  • मेरे लिए Markdown की बड़ी ताकतों में से एक यह है कि यह आधा WYSIWYG जैसा है
    इसका बेसिक syntax वैसे तरीकों को दोबारा इस्तेमाल करता है जिनसे लोग पहले से टेक्स्ट में formatting की नकल करते थे, इसलिए लिखा हुआ इनपुट खुद ही काफ़ी हद तक पढ़ने योग्य रहता है
    Markdown लिखना ठीक-ठीक न भी आता हो, तब भी ज़्यादातर मामलों में पढ़ने में दिक्कत नहीं होती; table table जैसी दिखती है और paragraph बस paragraph जैसा दिखता है
    कभी-कभी syntax दोबारा देखना पड़ता है, लेकिन वह ठीक है। passive vocabulary का active vocabulary से बड़ा होना स्वाभाविक है
    इसलिए मैं आम तौर पर इनपुट source की पठनीयता से आकलन करता हूँ, और यहाँ दिखी कई चीज़ों में उस पैमाने पर बहुत बड़ा फायदा नज़र नहीं आता
    हाँ, math formatting के उदाहरण मैंने नहीं देखे, और मैं LaTeX जिन कम मौकों पर इस्तेमाल करता हूँ, उनमें ज़्यादातर वजह वही गणितीय अभिव्यक्तियाँ होती हैं जो Markdown में नहीं हो पातीं, इसलिए वह हिस्सा व्यवहार में कैसा दिखता है यह जानने की जिज्ञासा है
  • यह दलील काफ़ी ठोस है
    फिर भी Quarkdown सीधा LaTeX लिखने से साफ़ तौर पर बेहतर superset जैसा लगता है, और Word जैसे GUI एडिटर की तुलना में output की predictability और LLM-सहायता प्राप्त editing के साथ compatibility भी बेहतर लगती है
  • बस एक और ज़्यादा सुपरपावर वाला Quarkdown बना लो, जिसमें कोई अजीब नए कमांड याद न करने पड़ें और बढ़िया UI/UX भी हो
    उसका नाम Microsoft Word रख सकते हैं
  • मैं भी एक छोटा Markdown renderer बना रहा हूँ, और उसका नाम रखना भी मुश्किल है, पूरा होने के बाद लोगों से उसे इस्तेमाल करवाना तो उससे भी ज़्यादा कठिन
    आजकल सिर्फ़ साधारण "plain markdown" एडिटर से अलग नज़र आना मुश्किल है, और HN के फ्रंट पेज तक पहुँचना हो तो लगता है कि सामान्य Markdown से आगे की functional completeness चाहिए ही
    यह किसी तरह का natural selection जैसा लगता है
  • Obsidian.md बेसिक Markdown के लिए एक शानदार WYSIWYG एडिटर है

• अच्छा होगा अगर ऐसे tools और markup languages की तुलना एक ही जगह मिल जाए
  MyST, Pandoc, Quarkdown, Quarto, Typst को साथ रखकर देखना बढ़िया रहेगा
  Quarto और Pandoc, Pandoc Markdown का इस्तेमाल करते हैं, और https://www.zettlr.com/ भी ऐसा ही करता है
  वहीं Quarkdown और Typst, LaTeX या HTML+Javascript की तरफ़ ज़्यादा झुकती हुई programmable markup languages जैसी लगती हैं, इसलिए अभी यह तय नहीं है कि असली LaTeX उत्तराधिकारी कौन बनेगा

  • मैंने इनमें से ज़्यादातर खुद इस्तेमाल किए हैं और आगे भी करता रहूँगा, तो मोटे तौर पर इन्हें ऐसे बाँट सकते हैं
    Markdown बस .txt पर थोड़ी syntax sugar डालने जैसा है, और उसे PDF या HTML में export किया जा सकता है
    Quarto वह Markdown है जिसमें आप code blocks चलाना चाहते हैं
    Typst आधुनिक ढंग से फिर से बनाया गया LaTeX है, जिसमें 90% झंझट कम हो गया है, लेकिन शायद 10% फीचर भी साथ ही कम हो गए हैं
    अकादमिक दुनिया वैसे भी नई चीज़ों से कतराती है, इसलिए Typst इस्तेमाल करने पर भी शायद बहुत उत्साह न मिले
    Pandoc आख़िरकार PDF, HTML जैसे कई formats में export करने का tool है
    आम तौर पर जल्दी समझ में आ जाता है कि किस तरफ़ का tool चाहिए, और asciidoc जैसी चीज़ें भी हैं, लेकिन अगर सोचें कि markdown/quarto/typst संयोजन किन क्षेत्रों को cover नहीं करता, तो वे बहुत ज़्यादा नहीं हैं
    जो बचता है वह शायद WYSIWYG एडिटर जैसा कुछ है
  • तुलना सूची में djot भी जोड़ा जा सकता है
    यह Markdown का काफ़ी अच्छी तरह डिज़ाइन किया हुआ और काफ़ी thorough superset लगता है
    https://djot.net/
  • मैं Typst को सच में पसंद करना चाहता था
    अगर LaTeX का इस्तेमाल और कम करना पड़ता तो बहुत अच्छा होता, लेकिन असली प्रोजेक्ट्स में आज़माने पर corner cases इतने ज़्यादा निकले कि आखिरकार फिर LaTeX पर लौटना पड़ा
    LaTeX की कुछ चीज़ें इसमें नहीं हैं, और Pandoc compatibility की कमी भी बड़ा कारण थी
    सच में उम्मीद है कि बस आख़िरी 10% भी पूरा हो जाए
  • अगर ऐसी तुलना की बात हो रही है, तो वह पहले से मौजूद है
    https://github.com/iamgio/quarkdown#comparison
  • Pandoc बाकी tools से अलग layer पर है
    उसके intermediate JSON format पर मनचाहे filters लगाए जा सकते हैं, इसलिए व्यावहारिक रूप से लगभग कोई भी conversion implement किया जा सकता है, और वह तरह-तरह के formats को उस JSON में या उससे वापस बदल देता है
    इसलिए मैं Pandoc-आधारित systems को पसंद करता हूँ, और जो काम base tool नहीं कर पाता, वह भी अक्सर एक छोटे inline filter से हो जाता है

• physics software standard model के हिसाब से Quarkdown को Atom में एडिट करो तो वह Quarkup बन जाता है, और Neutron Mail को Proton Mail से बदलना पड़ता है
  लेकिन यह तभी काम करता है जब आप बाएँ हाथ से टाइप करते हुए Electron app बनाओ और साथ में anti-Neutrinos AI blogpost भी लिखो

• मेरी छोटी-सी राय में, यह असल में LaTeX-style macros वाले Markdown के काफ़ी करीब है
  बस यहाँ उन्हें functions कहा गया है, शायद इसलिए कि कम-से-कम एक ऐसा function तो है ही जिसके side effects हैं — वही जो नए functions define करता है
  "सब कुछ function है" वाली syntactic purity मुझे पसंद है, लेकिन structure और styling को HTML/CSS की तरह स्वाभाविक रूप से मिला देना थोड़ा mixed feeling देता है। हालाँकि वह सीमा पहले भी पूरी तरह साफ़ नहीं थी
  फिर भी यह काफ़ी अच्छा है, और Markdown को बहुत बदलने की कोशिशों पर लोगों की शंका भी समझ में आती है
  यह आलोचना भी सही है कि functions का ज़्यादा इस्तेमाल source की पठनीयता घटा सकता है, और कभी-कभी Turing-incompleteness भी एक फ़ायदा होती है
  लेकिन अगर इसे Markdown में functions जोड़ने के design के रूप में देखें, तो यह काफ़ी साफ़-सुथरा design है

• मैं Quarkdown का लेखक और project lead हूँ
  यह शुरुआत में एक विश्वविद्यालयी research project था, और दो साल बाद यह इस रूप में होगा, यह मैंने कभी नहीं सोचा था
  दिलचस्पी दिखाने के लिए धन्यवाद, मैं comments का जितना हो सके जवाब दूँगा

  • क्या v3 में bold syntax को "ठीक" करने का कोई इरादा है?
    मुझे हमेशा **bold** और *italic* की बजाय *bold* और _italic_ ज़्यादा सही लगे हैं
    Markdown का यह अतिरिक्त asterisk डिज़ाइन के लिहाज़ से कमज़ोर लगता है, और ख़ास तौर पर फ़ोन या टैबलेट पर Markdown एडिट करते समय काफ़ी असुविधाजनक भी है
  • टेक्स्ट फ़ॉर्मैट में functions डालने का विचार काफ़ी अनोखा लगता है
    GUI documents में भी macros से आम तौर पर बचा जाता है, इसलिए जिज्ञासा है कि क्या Quarkdown मूल रूप से जटिल और दोहराव वाले documents के लिए डिज़ाइन किया गया था
    सवाल लेने के लिए धन्यवाद
  • मैंने https://iamgio.eu/2025-12-10-accidentally-in-silicon-valley/ पढ़ा, अच्छा लगा कि चीज़ें आपके लिए ठीक चलीं

• docs को सरसरी तौर पर देखकर मुझे थोड़ा संदेह हुआ कि evaluation model इस काम के लिए सही बैठता है या नहीं
  text layout में आम तौर पर एक हिस्से में बदलाव करने पर दूसरी जगहों की placement बिगड़ जाती है, इसलिए layout pass को fixed point तक बार-बार चलाने वाली संरचना चाहिए
  Typst में इसके लिए context का concept है https://typst.app/docs/reference/context/, लेकिन Quarkdown में मुझे ऐसा कुछ नहीं दिखा। हो सकता है मैं चूक गया हूँ
  मैं किताब के काम में pandoc/md/LaTeX stack से Typst पर गया हूँ, और अब तक काफ़ी संतुष्ट हूँ
  आधुनिक language में programming जैसा अहसास अच्छा लगता है, और speed भी pandoc+LaTeX से बहुत बेहतर है
  https://functionalprogrammingstrategies.com/

• AsciiDoc के नज़रिए से देखें तो Quarkdown का syntax design साफ़-सुथरा लगता है, और खास तौर पर user-defined functions अच्छे लगते हैं
  लेकिन इस श्रेणी में असली कठिन हिस्सा source language से ज़्यादा output pipeline होता है
  cross-reference, admonition, conditional content, function-based reuse जैसी Markdown extensions को design के स्तर पर काफ़ी हद तक संभाला जा सकता है
  असली दीवार उसके बाद आती है, जैसे PDF/UA के अनुरूप tagged PDF, अलग-अलग environments में भी न डगमगाने वाले deterministic builds, multilingual document sites में hreflang और cross-document linking, या 500 पेज की किताब में भी टिके रहने वाला incremental rebuild
  खास तौर पर EU में 28 जून 2025 से European Accessibility Act लागू होने के बाद PDF/UA की अहमियत और बढ़ गई है
  आपके चार doctype, खासकर paged वाले हिस्से, को आगे कैसे ले जाने की योजना है, यह जानना चाहूँगा

• तुलना तालिका में MyST भी होना चाहिए
  https://mystmd.org/
  यह आगे चलकर नया Markdown standard भी बन सकता है

  • या Typst को भी शामिल किया जा सकता है
    यह Markdown extension नहीं है, लेकिन इसका लक्ष्य और use cases काफ़ी मिलते-जुलते हैं
  • MyST + Sphinx का संयोजन बहुत अच्छा है
    बस मज़बूत LSP support की कमी खलती है, कम-से-कम मैं helix में इसे ठीक से चलाने में सफल नहीं हुआ
    मेरा ब्लॉग भी pydata-sphinx-theme और myst पर बना है
  • मैं उस तरफ़ ज़्यादा परिचित नहीं हूँ
    चाहो तो PR के ज़रिए तालिका खुद अपडेट कर सकते हो

• अपने app में मैंने थोड़ा अलग रास्ता चुना है
  मैंने पठनीयता और बड़े Mermaid diagrams को आसानी से संभालने पर ध्यान दिया, और हाल में map की तरह navigate करने वाला fullscreen mode भी जोड़ा है
  https://mdview.io/s/97af684b

• SSG इस्तेमाल करते समय मैं आम तौर पर input को जितना हो सके साफ़ Markdown में रखना पसंद करता हूँ, और formatting की बारीकियाँ CSS में डाल देता हूँ
  उदाहरण के लिए .abstract जैसा कुछ लिखने की ज़रूरत नहीं; CSS को ही पहला paragraph abstract की तरह ट्रीट करने दिया जा सकता है
  इसके उलट यह project ज़्यादा समृद्ध self-contained documents बनाने की दिशा में दिखता है
  इसमें CSS नहीं है, लेकिन पहले से परिभाषित styling options बहुत हैं, इसलिए बार-बार शुरुआती HTML की याद आती है
  HTML 1 में न रंग थे, न लगभग कोई formatting, इसलिए वह Markdown जैसा था; फिर HTML 3 तक आते-आते बहुत सी चीज़ें जुड़ने लगीं, तो यह उसी प्रवाह जैसा लगता है