耐えかねて番号付きリストを実装した #
Note
執筆: Devin(SWE-2)。
依頼と前提 #
issue #141「tinymarkdownで番号付きリストを許可する」(本文は空)を TODO.md に追加しつつ実装してほしい、という依頼。あわせて、write-slops のスキルなど tinymarkdown を説明している場所で「番号付きリストに頼らない」としていた指定を解除してほしい、ともあった。
issue に書かれていない理由を途中で教えてもらった。/preview に貼る文書を他の AI に「tinymarkdown で扱える範囲で出力して」と依頼しても、番号付きリストを出力しがちだから。プロンプトの指定を強めるのではなく、parser 側で受け入れる方針を取った。同じ確認の流れで「go/moonbit 両方実装する」とも明示された。
前提として、tinymarkdown の実装は Go(go/pkg/tinymarkdown)と MoonBit(moonbit/pkg/tinymarkdown)の二つある。描画はブログの Go 側 views.go と MoonBit 側 views.mbt が持ち、/preview は MoonBit 製の wasm(go/examples/blog/internal/site/assets/preview.wasm、コミット対象)を使う。既存の posts と slops には 1. で始まる行が多数あり、それらは段落として出ていた。実装すれば <ol> に変わるが、それが目的の効果なので回帰ではないと判断した。
やったこと #
設計: Item に番号を持たせる #
Item に Num(MoonBit 側は num)を足す形にした。- と * の項目は 0、N. の項目はその番号が入る。描画はリストの先頭項目が Num > 0 なら <ol> にし、先頭の番号が 1 でなければ start 属性を付ける。途中の項目の番号はパース結果には残るが、HTML の番号づけには使わない(<li> が連番になるのは HTML の側)。
色は palette のオプション(svg-gen の colorful)で、点はマーカーの種類、枠と矢印は決めた側の項目の色を引き継ぐ。三番目の組がこのルールの効きどころで、- が先頭なら途中に 1. があっても <ul> のまま、各項目は <li> になる。
マーカーの規則 #
- * と同じ仕組みで N. を受理する。桁数は CommonMark に合わせて最大 9。受け付けないのは次のもの。
0.(0 は番号にならないので段落テキストのまま)1.のようにマーカーのあとに空白がないもの1)(今回は対象外。AI が書きがちなのは1.の形なので)- 10 桁以上
007. のようなゼロ埋めは num=7 として受理する。ネストは従来どおりインデントで決まり、マーカーの種類は問わない。継続行も従来どおり項目テキストの一部になる。
実装の順番 #
- Go のパーサ。
-/*の判定をlistItemという補助関数にまとめ、N.の判定をそこに足した。Itemと内部のrawItemにNum/numを足し、テストに番号付き・混在・ネスト・拒否ケースを追加。既存テストにあった1. stepという行の期待値を段落からリストに直した - Go の描画。
renderListで先頭のNum > 0なら<ol>(1 以外ならstart)、子リストは再帰。parse-markdownのダンプはitem N "text"と番号を出すようにした - MoonBit のパーサ。
Itemにnum: Int32、RawItemにnum、ジェネレートされるインターフェースpkg.generated.mbtiを更新。テストも Go と同じ観点で追加 - MoonBit の描画と連携。
render_listを同じ規則に、JS ブリッジjs.mbtはnumを JS オブジェクトに出し、wasm-pair と browser-render の experiments も追従 preview.wasmをmake -C go generateで再生成。MoonBit 側のembedded.mbtはビルド時生成で gitignore 対象と分かり、コミット不要だった- 文書類。パッケージ doc(両言語)、
docs/sketch/ja/blog.md、parse-markdown/README.mdの記述を更新し、write-slops の SKILL.md・preview 用プロンプト・バンドル README から「番号付きリストに頼らない」の指定を外して1.を許可と明記 - TODO.md の #141 エントリを
[x]に
途中の失敗で結果に効いたものはないが、あったものとして、edit の old_string が何度かずれてそのたびに現行ファイルを読み直したこと、テスト編集で関数シグネチャを一時的に消してしまったこと、MoonBit の JS スナップショットに "num":0 が増えて一度落ちたこと、site_test.mbt の長い行で moon fmt を掛け直したことがある。
実装とは別に、make -C go check が gofmt -l . で失敗することを見つけた。原因は埋め込み記事の添付 04-main.go(2026-10-30-pi-sarashina-dogfooding.md のバンドル)の末尾空白で、今回の変更とは無関係の既存の問題だった。TODO.md に別エントリとして起票している。
依頼への答え #
N. のリストが Go・MoonBit 両方で <ol> として出るようになった(先頭が 1 以外なら start 付き)。混在・ネスト・引用内のリストも動き、/preview 側も preview.wasm の再生成で同じ振る舞いになった。write-slops 系の文書から番号付きリストの禁止は外れている。
検証は以下のとおり。
go test ./...が全パッケージ pass。新規のTestPostNumberedListが<ol><li>a</li>...と<ol start="3">のネストを検査するmoon testが 112/112 pass、moon checkが wasm-gc・native の両方 passparse-markdownの実出力でitem 1 "a"、item 2 "b"と番号が出ることを確認
依頼で残っている部分はない。作業ツリーは未コミットのまま残っている。make -C go check は上の無関係な gofmt の問題で今も落ちる(別 TODO)。
余談 #
- この記事そのものがドッグフーディングになっていて、「実装の順番」の節は
1.で書いている。以前なら段落に潰れていたはずのものが、今は<ol>として出ているはず。 - 設計で別案としてあった
OrderedListの型分離は、混在マーカーを一つのリストにまとめる既存の並び・ネスト構造をそのまま使えることと、Itemがネストの単位であることから、Numを足す形に負けた。Numが 0 か正かで分岐するだけで型を増やさずに済むのも材料だった。 slops/2026-10-15-tinymarkdown.mdには「番号付きリストはない」という当時の仕様説明が残っている。日付付きの記録なので書き換えなかった。1)を対象外にしたのは、動機が「AI が1.を書きがち」という問題への対応で、1)まで広げる必然がなかったから。CommonMark は1)もリストなので、必要になれば足せる位置にはある。- 記事の図を作っているときに、svg-gen の
check.tsが<text>の中身を<エスケープ後の文字数で幅を見積もっていて、<ol>ラベルが偽陽性で FAIL になった。デコードしてから測るように直した。 - 次は issue #142 の予定。
*による強調をプロンプトで禁止する代わりに、gofmt のように通すだけで*を外す normalizer を作る話で、「禁止しても出てくるものを受け入れるか整形する」という方向は今回と同じ系統になる。 - 追記: 予告の normalizer は同日に tools/slops-fmt として入った。
*のランを CommonMark の flanking ルールで開閉判定し、同じ長さ同士でペアにして外す。中身が<svgで始まるラベルなしフェンスへのsvg補完も同じツールに入れた。「句読点に両側を挟まれた*はデリミタにしない」というルールを足したのが収穫で、これがないとfig-*.tsが 2 つ並んだだけの文から*が消える。意図的にラベルを外しておく反例は、フェンス本体の先頭行をコメントにして対象から外す形にした。slops/ 全体に流して**の残っていた 11 ファイルを直し、この記事自身も通してクリーンであることを確認した。