[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_254":-5,"_257":258,"_259":260},"routes/shell",{"_135":136,"_253":-5,"_254":-5,"_255":256},"routes/repo",{"_128":-7,"_129":130,"_131":132,"_133":134,"_135":136,"_137":26,"_138":26,"_139":26,"_140":26,"_141":26,"_142":26,"_143":144,"_145":146,"_147":26,"_148":-7,"_149":-7,"_150":151,"_152":153,"_154":155,"_156":-5,"_157":158,"_159":160,"_161":162,"_163":164},"routes/repo.commit",{"_13":14,"_15":16,"_17":18},"commit",{"_99":22,"_104":105,"_106":107,"_108":109,"_110":111,"_112":-5,"_113":114,"_115":116},"diff",{"_19":20,"_21":22,"_23":24,"_25":26},"checks",[],"old","3d42db0e9d0df3063943c8e1f5247b76fa9d3265","new","8ddd031ff0263d64433067470df11ea9372e091f","files",[27],"truncated",false,{"_28":29,"_19":30,"_21":31,"_32":33,"_34":35,"_36":37,"_38":39},"path","crates/tidy/src/markdown/handoff.md",{"_99":103,"_101":102},{"_99":100,"_101":102},"kind","text","add",3,"del",2,"hunks",[40,41,42],{"_43":84,"_45":49,"_47":84,"_48":49,"_50":85},{"_43":68,"_45":49,"_47":68,"_48":49,"_50":69},{"_43":44,"_45":46,"_47":44,"_48":49,"_50":51},"aStart",62,"aLen",6,"bStart","bLen",7,"ops",[52,53,54,55,56,57,58],{"_59":60,"_61":67},{"_59":60,"_61":66},{"_59":60,"_61":65},{"_59":34,"_61":64},{"_59":60,"_61":62},{"_59":60,"_61":63},{"_59":60,"_61":62},"tag","eq","line","","## Wrapping","- A code span over two lines keeps its second line as written. Prettier writes it from the parsed value without the container's indent or `>`, so in a list item the indent then eats spaces that belong to the code.","- An emphasis mark right after a `*` is `_`. Prettier writes `*`, which merges into `***` and nests the other way.","- Link targets and definitions stay as written where Prettier's form would read differently: unbalanced parentheses, `<`, `>`, a backslash, text that decodes as an entity, or a title with `(` in parentheses.","- With `wrap: never`, the line after a hard break in a one-line footnote keeps its indent. Prettier drops it, which reads the same but worse.",51,[70,71,72,73,74,75,76,77],{"_59":60,"_61":62},{"_59":60,"_61":83},{"_59":60,"_61":82},{"_59":36,"_61":81},{"_59":34,"_61":80},{"_59":60,"_61":79},{"_59":60,"_61":62},{"_59":60,"_61":78},"Kept on purpose:","4. pulldown-cmark doesn't close a fence followed by tabs (```` ```→→ ````), which CommonMark allows, so the rest of the file reads as code. That's a parser bug to report upstream.","3. Prettier escapes a `_` or `*` in text that could open emphasis (`\\_#include`); mdtidy copies text as written, which reads the same.","3. A code span over two lines in a list item or quote: Prettier writes the second line with no indent and no `>`. That still parses the same but reads worse, so it isn't planned.","2. A `|` inside a code span in a table cell splits the cell in GFM, and Prettier trims the pieces differently.","1. Deep Hugo templates (bootstrap's `examples/_index.md`): Prettier reads nested Liquid and HTML as HTML blocks and keeps their lines as written.",41,[86,87,88,89,90,91,92,93],{"_59":60,"_61":62},{"_59":60,"_61":98},{"_59":60,"_61":97},{"_59":36,"_61":96},{"_59":34,"_61":95},{"_59":60,"_61":62},{"_59":60,"_61":94},{"_59":60,"_61":62},"## Known gaps against Prettier","- **Prettier**: the target is Prettier 3.9.10. `mise run oracle:prettier -- ... [--show ]` formats one copy with Prettier (cached in `target/oracle`), one with mdtidy, counts identical files, and sorts the differences by kind. It hands mdtidy every file by name, because the CLI skips hidden folders on purpose. Last result: A 871/872, B 2,141/2,142, C 3,456/3,466, D 290/310. The semantics oracle passes on all four. `bun fmt` is close (8 misses, all inside code blocks) but it is not the reference.","- **Prettier**: the target is Prettier 3.9.10. `mise run oracle:prettier -- ... [--show ]` formats one copy with Prettier (cached in `target/oracle`), one with mdtidy, counts identical files, and sorts the differences by kind. It hands mdtidy every file by name, because the CLI skips hidden folders on purpose. Last result: A 871/872, B 2,141/2,142, C 3,455/3,466, D 290/310. The semantics oracle passes on all four. `bun fmt` is close (8 misses, all inside code blocks) but it is not the reference.","- **Speed**: `mise run bench:ab -- [--rev ] ...` builds the working tree and `` (HEAD by default, in a temporary worktree), times both checking the folders in both orders, and compares medians: means swing with machine load. Each fix on 2026-10-30 and 2026-11-01 was within noise; together they cost about 2–3% (about 38 to 39 ms on A + B).","- **Semantics**: `MDTIDY_CORPUS=[:...] mise run oracle:semantics`. Every output re-parses to the same events (adjacent text merged, soft breaks as spaces, whitespace collapsed) and settles after one pass. It runs the Prettier preset, the Preserve preset, `wrap: always` at width 40, and `wrap: never`. It caught every real bug so far: trust it over reading diffs. When a file fails, `mise run oracle:shrink -- [mdtidy options...]` removes lines while it still fails and prints the few that are left. The events it compares come from `tests/support/events.rs`, shared by the test and the `events` example.","oid","1a51fe1","mode","100644","32d68ef","parents",[20],"author",{"_118":119,"_120":121,"_126":127},"committer",{"_118":119,"_120":121,"_126":127},"message","docs: update handoff\n\nRecord why two-line code spans stay as written, the lazy Liquid fix,\nand the gaps left.","signature","subject","docs: update handoff","authors",[117],{"_118":119,"_120":121,"_122":123,"_124":125},"name","Luke Edwards","email","luke.edwards05@gmail.com","login","lukeed","avatarUrl","https://avatars.githubusercontent.com/u/5855893?v=4","time",1793555960,"documentNavigation","repo","lukeed/tidy","repoId","b2cac5cc-818f-4958-803a-7d401ccd9a90","ownerId","user:5855893","site","nexthub","private","admin","settings","maintainer","triage","starred","stars",0,"watchers",1,"watching","pinned","notify","views",[209,210,211,212,213,214,215,216,217,218,219,220,221],"navigation",{"_150":151,"_171":172,"_173":174,"_175":176,"_177":178,"_179":180,"_59":181},"sources",[],"viewer","meta",{"_166":62,"_167":123,"_168":62,"_137":26,"_169":165,"_170":26,"_143":144,"_145":146},"branches",[165],"tags",[],"cloneUrl","https://git.nexthub.sh/lukeed/tidy.git","main","description","owner","section","head","empty","pins",[192,193,194],"documents",{"_189":190,"_191":144},"code",{"_186":187,"_188":144},"automations",{"_184":37,"_185":-5},"delivery",{"_182":144,"_183":-5},"W1_y18R9FUcyveBRlHeRXdVTtjo","releases","applications","workflows","deployments","commits",350,"changes","counts",{},"total",{"_195":188,"_118":207,"_28":188,"_198":208,"_148":200,"_201":26,"_202":200,"_203":144},{"_195":204,"_118":205,"_28":204,"_198":206,"_148":200,"_201":26,"_202":200,"_203":144},{"_195":196,"_118":197,"_28":196,"_198":199,"_148":200,"_201":26,"_202":200,"_203":144},"id","issues","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_195":188,"_118":207,"_28":188,"_198":252,"_148":200,"_201":26,"_202":200},{"_195":204,"_118":205,"_28":204,"_198":251,"_148":200,"_201":26,"_202":200},{"_195":196,"_118":197,"_28":196,"_198":250,"_148":200,"_201":26,"_202":200},{"_195":247,"_118":248,"_28":247,"_198":249,"_148":26,"_201":26,"_202":200},{"_195":244,"_118":245,"_28":244,"_198":246,"_148":26,"_201":26,"_202":200},{"_195":184,"_118":242,"_28":177,"_198":243,"_148":26,"_201":26,"_202":200},{"_195":185,"_118":239,"_28":240,"_198":241,"_148":26,"_201":26,"_202":200},{"_195":182,"_118":237,"_28":182,"_198":238,"_148":26,"_201":26,"_202":200},{"_195":233,"_118":234,"_28":235,"_198":236,"_148":26,"_201":26,"_202":200},{"_195":173,"_118":231,"_28":173,"_198":232,"_148":26,"_201":26,"_202":26},{"_195":228,"_118":229,"_28":228,"_198":230,"_148":26,"_201":26,"_202":26},{"_195":225,"_118":226,"_28":225,"_198":227,"_148":26,"_201":26,"_202":26},{"_195":222,"_118":223,"_28":222,"_198":224,"_148":26,"_201":26,"_202":26},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794579187432,"sidebar","expanded"]