Quarkdown - 強力な機能を備えたMarkdown
(quarkdown.com)- Markdownベースの文書作成にLaTeXレベルの組版機能を組み合わせ、論文から書籍・プレゼンテーション・静的サイト・ナレッジベースまでを1つのツールで扱えるように構成されている
- ボイラープレートを減らした構文の中に、著者、余白、要旨、画像、引用文といった要素を直接埋め込み、本文とレイアウトを一緒に記述できる
- 1行の
.doctype設定でpaged、plain、docs、slidesの文書タイプを切り替えられ、インタラクティブなプレゼンテーションまでサポートする - 高速コンパイルとライブプレビューを提供し、Turing complete なスクリプティングによって関数と引数の再利用が可能で、繰り返しのレイアウト作業を減らせる
- 無料の オープンソース として提供され、GitHubで10K stars以上、VS Code連携、Quickstartとドキュメント資料も備え、実運用や拡張の道筋を広げてくれる
主な特徴
- Markdown に LaTeXレベルの組版機能 を組み合わせた、現代的な文書作成システム
- 論文、書籍、プレゼンテーション、静的サイト、ナレッジベースまでを1つのツールで扱えるように構成されている
- 無料で オープンソース として提供され、コンパイラは継続的に進化しており、自由ソフトウェアとして維持されている
- Quarkdown, Wiki, Discuss
執筆体験
- ボイラープレートなしで 執筆に集中できるよう設計されている
docauthor、pagemargin、abstract、画像、引用文といった要素を構文の中に直接入れ込み、文書レイアウトと本文を一緒に扱える- サンプル文書は、タイトル、著者、余白、画像、要旨、引用文を1つのファイル内にまとめて記述する流れで構成されている
- 拡張構文 によって、基本的なMarkdownよりも豊かな表現が可能
文書タイプと doctype
- 文書タイプは1行の
.doctype設定で切り替えられる pagedは記事、書籍、レポート向けplainはノート、ナレッジベース、シンプルな静的Webサイト向けdocsはWiki、技術文書、大規模ナレッジベース向けslidesは講義、発表、インタラクティブなプレゼンテーション 向け
レスポンシブプレビューとスクリプティング
- 高速コンパイル とライブプレビューにより、入力しながら即座に結果を確認できる
- 繰り返し作業を減らすための Turing complete なスクリプティング機能を含む
- 関数定義と引数の再利用により、同じレイアウトパターンを複数の項目に適用できる
- 例では
animal関数を定義した後、名前、生態系、図版構成を再利用して複数の項目を生成している
インストールと開始方法
- インストールセクションでは v2.0.0 が2026年4月23日にリリースされたと表示されている
- 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 javascoop bucket add quarkdown https://github.com/quarkdown-labs/scoop-quarkdownscoop install quarkdown
- Explore
- Get started →
エコシステムと資料
- GitHubで 10K stars以上 を獲得している状態と表示されている
- Quickstart, Docs, VS Code, Wiki により、学習やエディタ連携の導線が提供されている
1件のコメント
Hacker Newsの意見
正直、印象的ではあるけれど、自分にとってMarkdownの核心は極端なまでの単純さにある
GUIがなくても編集できるし、ターミナルのVIMで書いていても結果がだいたいどうなるか見当がつくし、生の
.mdファイル自体もそのまま読みやすいでもそこに機能をどんどん積み始めると、見慣れないコマンドを何度も調べることになり、結局は覚えられず、レンダリングなしでは見た目にも自信が持てなくなって、WYSIWYGエディタが欲しくなる
QWERTYキーボードにキリル文字、デーヴァナーガリー、中国語、アラビア語のキーまで全部載せようという発想に近く見えて、そうなると結局またhunt and peckに戻る感じがする
基本文法が、もともと人々がテキストで書式を真似していたやり方を再利用しているので、入力自体がそのままだいたい読みやすい
Markdownの書き方を正確に知らなくても、たいてい読むのに困らないし、表は表に見えるし、段落はただの段落に見える
ときどき文法を調べ直すことはあるけれど、それは別に構わない。能動語彙より受動語彙のほうが大きいのは自然なことだ
だから自分は入力された原文の可読性で判断するほうだが、ここで示されているものの多くは、その基準ではあまり大きな得失があるように見えない
ただ、数式フォーマットの例は見ておらず、自分がLaTeXを使う数少ない場面もたいていMarkdownでは書けない数式が理由なので、その部分が実際どう見えるのかは気になる
それでもQuarkdownは、LaTeXを直接打つよりは明らかに上位互換に見えるし、WordのようなGUIエディタよりも結果の予測しやすさやLLM補助編集との相性も良さそうだ
名前はMicrosoft Wordでいいだろう
最近は普通の"plain markdown"エディタだけでは目立ちにくく、HNのトップページまで行くには結局、一般的なMarkdownを超える機能性と完成度が必要なのだと思う
一種の自然選択のように感じる
こうしたツールやマークアップ言語を一度に比較した資料があるといい
MyST、Pandoc、Quarkdown、Quarto、Typstを並べて見てみたい
QuartoとPandocはPandoc Markdownを使っていて、https://www.zettlr.com/も同様だ
一方でQuarkdownとTypstはLaTeXやHTML+Javascript寄りのプログラマブルなマークアップ言語という感じなので、まだ誰が本当のLaTeXの後継になるのかは決まっていないように見える
Markdownは
.txtに少しだけ文法的な糖衣をかけたもので、PDFやHTMLにエクスポートできるQuartoはコードブロックを実行したいMarkdownで、
Typstは現代風に作り直したLaTeXで、ごちゃごちゃした部分が90%減った代わりに機能も10%くらい抜けている感じだ
学界はもともと新しいものを嫌うので、Typstを使っても歓迎されない可能性が高い
Pandocは結局のところPDFやHTMLのような各種フォーマットへエクスポートするためのツールだ
たいてい必要な道具がどちら側かはすぐ分かるし、asciidocのようなものもあるが、markdown/quarto/typstの組み合わせでカバーできない領域が何かと考えると、それほど多くはない
せいぜい残るのはWYSIWYGエディタくらいだ
Markdownのよく設計された、かなり徹底したsupersetに見える
https://djot.net/
LaTeXをもう使わずに済むなら最高だったが、実際のプロジェクトで使ってみるとコーナーケースが多すぎて、結局またLaTeXに戻った
LaTeXにあって欠けている部分もあるし、Pandocとの変換性が弱いのも大きかった
最後の10%が埋まってくれることを本当に願っている
https://github.com/iamgio/quarkdown#comparison
中間のJSONフォーマットに対して任意のフィルタを掛けられるので、望む変換は事実上なんでも実装できるし、各種フォーマットをそのJSONに、またはその逆に変換してくれる
だから自分はPandocベースのシステムを好んでいて、標準ツールでできないことも簡単なinline filterで解決できることが多い
物理ソフトウェア標準モデルによれば、QuarkdownはAtomで編集するとQuarkupになり、Neutron MailはProton Mailに替えなければならない
ただし、左手でタイピングしながらElectronアプリを作り、anti-Neutrinos AI blogpostまで書いてはじめて動作する
短く評するなら、これは実質的にLaTeXスタイルのマクロを入れたMarkdownに近い
ただしここではそれを関数と呼んでいて、おそらく副作用のある関数が少なくともひとつはあるからだろう。新しい関数を定義するその関数のことだ
「すべてが関数」という文法的な純粋さは気に入っているが、構造とスタイリングをHTML/CSS風に自然に混ぜているのは少し微妙だ。もっとも、その境界自体ももともと曖昧ではあった
それでもかなりクールだし、Markdownを大きく変えようとする試みに懐疑的な反応が多いのも理解できる
関数を使いすぎると原文の可読性が落ちるという批判ももっともで、ときにはチューリング不完全性が利点になることもある
しかしMarkdownに関数を加える設計として見るなら、これはかなりクリーンなデザインの部類だと思う
自分はQuarkdownの作者であり、プロジェクトリードだ
最初は大学の研究プロジェクトとして始まったが、2年後にこんな姿になるとは想像もしていなかった
関心を持ってくれてありがとう。コメントにはできるだけ返信していくつもりだ
自分はずっと、
**bold**と*italic*よりも*bold*と_italic_のほうが理にかなっていると思ってきたMarkdownの余分なアスタリスク1個は設計としていまひとつだし、特にスマホやタブレットでMarkdownを書くときにはかなり不便だ
GUI文書でもマクロは普通あまり使わないものだし、Quarkdownはもともと複雑で反復的な文書のために設計されたのか気になる
質問を受け付けてくれてありがとう
ドキュメントをざっと見た限り、評価モデルがこの作業に向いているのか少し心配だ
テキストレイアウトでは、ある部分を調整すると別の部分の配置が崩れて再度レイアウトパスを回す必要があることが多く、不動点に達するまで反復する構造が必要になる
Typstにはそのためのcontextという概念があるが https://typst.app/docs/reference/context/、Quarkdownでは似たものを見かけなかった。見落としているだけかもしれない
自分は本の作業でpandoc/md/LaTeXの組み合わせからTypstに乗り換え、かなり満足している
モダンな言語でプログラミングしている感覚が心地よく、速度もpandoc+LaTeXよりずっと速い
https://functionalprogrammingstrategies.com/
AsciiDocの側から見ると、Quarkdownの文法設計はクリーンに見えるし、とくにユーザー定義関数が良い
ただ、この種のものでもっと難しいのは、ソース言語そのものより出力パイプラインだと感じる
相互参照、admonition、条件付きコンテンツ、関数ベースの再利用のようなMarkdown拡張は、設計次第で十分扱える
本当の壁はその先で、たとえばPDF/UAに準拠したtagged PDF、環境が違っても揺れないdeterministic build、多言語ドキュメントサイトにおけるhreflangやcross-document linking、500ページの本でも耐えるincremental rebuildといったものだ
とくにEUでは、2025年6月28日にEuropean Accessibility Actが施行された後、PDF/UAの重要性がさらに高まった
4つのdoctype、とくにpagedをどう進めていくつもりなのか気になる
比較表にはMySTも入るべきだ
https://mystmd.org/
こちらが今後の新しいMarkdown標準になる可能性もありそうだ
Markdown拡張ではないが、目標やユースケースがかなり近い
ただ、強力なLSPサポートが惜しく、少なくとも自分はhelixでうまく動かせなかった
自分のブログもpydata-sphinx-themeとmystで作っている
よければPRで表を直接更新してほしい
自分のアプリでは少し違うアプローチを取った
可読性と大きなMermaidダイアグラムを扱いやすくすることに集中し、最近では地図のようにたどれる全画面モードも追加した
https://mdview.io/s/97af684b
自分はSSGを使うとき、入力はできるだけクリーンなMarkdownのままにして、書式の詳細はCSSに寄せるほうを好む
たとえば
.abstractのようなものをわざわざ書かなくても、CSS側で最初の段落をabstractとして扱えばいいそれに対してこのプロジェクトは、より豊かな自己完結型ドキュメントを作る方向に見える
CSSはないが、あらかじめ定義されたスタイリングオプションが多く、そのせいで初期のHTMLを思い出す
HTML 1には色もほとんど書式もなくMarkdownに近かったが、HTML 3あたりになるといろいろ入り始めたので、その流れに似ているように見える