Gloss,Nest 拡張 Markdown 説明 と例
この
.n.md
目次
概要 - Gloss
- ruby（
- gloss（
-
- ... と ...（
- Nest（
見出 しで区切 る）
-
- break ## / --- / ;;;）
- Nest の
設計 の考 えかた（AST前提 ）実装 者 むけ注意 （曖昧 さを減 らす）- テンプレート
概要
この
1. Gloss：
2. Nest：#〜######）で
改行
による改行ではなくて、
で改行です
.n.mdで改行されていたら改行して表示されるし、
と書かれていても改行して表示します
Gloss
ruby（[漢字/かんじ]）
ruby は [漢字/かんじ] の
[私/わたし]は[漢字/かんじ][交/ま]じりの[文/ぶん]を[書/か]く[東/ひがし][京/きょう]へ[行/い]く[微分/びぶん][係数/けいすう]
ruby の規則
[漢字/かんじ]のように、/の左 が表示 される本文 、/の右 が ruby（読 み）です- かな・カタカナ・
数字 ・記号 には ruby を付 けません（ruby は「漢字 の読 み」を想定 します） - ruby は、gloss の
中 でも外 でも書 けます
gloss（{[日本語/にほんご]/English}）
gloss は {[日本語/にほんご]/English} の
{[微分/びぶん][係数/けいすう]/derivative}は{[接線/せっせん]/tangent}の傾 きを表 す{カルボン[酸/さん]/carboxylic acid}は{[弱酸/じゃくさん]/weak acid}として{[水溶液/すいようえき]/aqueous solution}で{[電離/でんり]/ionize}しやすい
gloss の意味
A{B/b}C とABC としてB のb が
本文 （base）：ABC注釈 （note）：b
多言語 gloss（{A/b/β}）
gloss は 3つ
{[台/たい][湾/わん]/台灣/Táiwān}へ[行/い]く[来年/らいねん]、{アテネ/Αθήνα/Athens}を[訪/おとず]れる[予定/よてい]だ{トルストイ/Лев Николаевич Толстой/Tolstoy}の[小説/しょうせつ]を[読/よ]む
注意
- base の
文字 は 1つの言語 で揃 えるのが推奨 です（見 た目 が安定 します） - ruby は base の
中 にも書 けます（たとえば{Kyoto/[京/きょう][都/と]}）
... と ...（数式 の保護 ）
$...$ と $$...$$ の
[酸素/さんそ]$\\mathrm{O_2}$・[珪素/けいそ]$\\mathrm{Si}$・[鉄/てつ]$\\mathrm{Fe}$$\\text{[地表/ちひょう]}のように、数式 の中 に[/]や{/}があっても、Gloss/ruby になりません
Nest（見出 しで区切 る）
基本 規則
Nest は、#〜######）が
##の下 にある###は、##の節 の子 になります同 じ深 さの見出 しが来 ると、同 じ親 の兄弟 節 になります- もっと
浅 い見出 しが来 ると、深 い節 が閉 じます
break 規則 （## / --- / ;;;）
この
1) より高位 の見出 し（たとえば ##）
###の途中 で##が出 たら、###（およびそれより深 い節 ）は全部 閉 じます新 しい##の節 が始 まります
2) ---（Thematic break）
---は水平線 として表示 されます- そのあと、Nest を 1
段 だけ閉 じます（;;;と同 じ “1段 close”） ----のように、-が3つより多 いものは、ただの水平線 として扱 います Nestに干渉 しません
3) ;;;（Section break）
;;;は表示 しません（節 を閉 じる命令 だけ）- Nest を 1
段 だけ閉 じます - 2
段 閉 じたいなら;;;を 2回 書 きます
Nest の例
節 A（##）
この
節 A-1（###）
A-1 の
;;;
A-1 を 1
節 A-2（###）
A-2 の
--- は
なので、ここは A の
節 B（##）
## が
節 B-1（###）
B-1 の
節 B-1-a（####）
B-1-a の
節 C（##）
ここで B-1-a / B-1 / B が
設計 の考 えかた（AST 前提 ）
この
AST の例 （概略 ）
- Document
- Section(level=2, heading="A")
- Paragraph(...)
- Section(level=3, heading="A-1")
- Paragraph(...)
- Paragraph(...) # after ;;;
- Section(level=3, heading="A-2")
- Paragraph(...)
- ThematicBreak # ---
- Paragraph(...) # after ---
- Section(level=2, heading="B")
- ...
実装 者 むけ注意
曖昧 さを減 らす推奨
この
見出 しは ATX（#）だけを使 う（Setext は使 わない）---は単独 行 だけを水平線 として扱 う;;;も単独 行 だけを break として扱 う\\{\\/のような簡単 な逃 げ（escape）を用意 する
テンプレート
題名 （##）
小 節 （###）
[例/れい]：{[接線/せっせん]/tangent}。
ここから
ここで