[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10,"_11":12},"actionData","errors","root",{"_260":-5,"_263":264,"_265":266},"routes/shell",{"_141":142,"_259":-5,"_260":-5,"_261":262},"routes/repo",{"_134":-7,"_135":136,"_137":138,"_139":140,"_141":142,"_143":26,"_144":26,"_145":26,"_146":26,"_147":26,"_148":26,"_149":150,"_151":152,"_153":26,"_154":-7,"_155":-7,"_156":157,"_158":159,"_160":161,"_162":-5,"_163":164,"_165":166,"_167":168,"_169":170},"routes/repo.commit",{"_13":14,"_15":16,"_17":18},"commit",{"_105":22,"_110":111,"_112":113,"_114":115,"_116":117,"_118":-5,"_119":120,"_121":122},"diff",{"_19":20,"_21":22,"_23":24,"_25":26},"checks",[],"old","46fea155ca8c58936b17edfb3b6cc9941c4d5f6a","new","57aac9ac614a85b7a747a3967ccfc227cf2d8382","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",{"_105":109,"_107":108},{"_105":106,"_107":108},"kind","text","add",5,"del",2,"hunks",[40,41,42],{"_43":90,"_45":50,"_47":90,"_49":50,"_51":91},{"_43":70,"_45":50,"_47":70,"_49":71,"_51":72},{"_43":44,"_45":46,"_47":48,"_49":50,"_51":52},"aStart",62,"aLen",6,"bStart",64,"bLen",7,"ops",[53,54,55,56,57,58,59],{"_60":61,"_62":69},{"_60":61,"_62":68},{"_60":61,"_62":67},{"_60":34,"_62":66},{"_60":61,"_62":65},{"_60":61,"_62":64},{"_60":61,"_62":63},"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.","- A blank line before a nested list in a list item stays when it is all that keeps the list loose; Prettier drops it, and the list turns tight.","- 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.",52,9,[73,74,75,76,77,78,79,80,81,82],{"_60":61,"_62":89},{"_60":61,"_62":88},{"_60":61,"_62":87},{"_60":36,"_62":86},{"_60":34,"_62":85},{"_60":34,"_62":64},{"_60":34,"_62":84},{"_60":61,"_62":64},{"_60":61,"_62":83},{"_60":61,"_62":64},"Kept on purpose:","What D (Prettier's fixtures) still misses, beyond those: Prettier-only syntax (`[[wiki links]]`, remark-math, the `@format` pragma), Liquid inside a table, a lazy `` after a nested item, and `encodedLink`, where Prettier percent-encodes a `>` and so changes the URL.","4. Two pulldown-cmark bugs to report upstream, both with tabs: it doesn't close a fence followed by tabs (```` ```→→ ````), so the rest of the file reads as code; and it reads a tab-indented `>` after a quote line as a quote marker, though a tab is 4 columns. mdtidy follows pulldown-cmark's reading.","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.","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,[92,93,94,95,96,97,98,99],{"_60":61,"_62":64},{"_60":61,"_62":104},{"_60":61,"_62":103},{"_60":36,"_62":102},{"_60":34,"_62":101},{"_60":61,"_62":64},{"_60":61,"_62":100},{"_60":61,"_62":64},"## 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 301/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,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.","- **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","aff6873","mode","100644","1a51fe1","parents",[20],"author",{"_124":125,"_126":127,"_132":133},"committer",{"_124":125,"_126":127,"_132":133},"message","docs: update handoff\n\nRecord corpus D's progress, the second pulldown-cmark tab bug, and\nthe nested-list blank line kept on purpose.","signature","subject","docs: update handoff","authors",[123],{"_124":125,"_126":127,"_128":129,"_130":131},"name","Luke Edwards","email","luke.edwards05@gmail.com","login","lukeed","avatarUrl","https://avatars.githubusercontent.com/u/5855893?v=4","time",1793562558,"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",[215,216,217,218,219,220,221,222,223,224,225,226,227],"navigation",{"_156":157,"_177":178,"_179":180,"_181":182,"_183":184,"_185":186,"_60":187},"sources",[],"viewer","meta",{"_172":64,"_173":129,"_174":64,"_143":26,"_175":171,"_176":26,"_149":150,"_151":152},"branches",[171],"tags",[],"cloneUrl","https://git.nexthub.sh/lukeed/tidy.git","main","description","owner","section","head","empty","pins",[198,199,200],"documents",{"_195":196,"_197":150},"code",{"_192":193,"_194":150},"automations",{"_190":37,"_191":-5},"delivery",{"_188":150,"_189":-5},"W1_y18R9FUcyveBRlHeRXdVTtjo","releases","applications","workflows","deployments","commits",350,"changes","counts",{},"total",{"_201":194,"_124":213,"_28":194,"_204":214,"_154":206,"_207":26,"_208":206,"_209":150},{"_201":210,"_124":211,"_28":210,"_204":212,"_154":206,"_207":26,"_208":206,"_209":150},{"_201":202,"_124":203,"_28":202,"_204":205,"_154":206,"_207":26,"_208":206,"_209":150},"id","issues","Issues","filters",{},true,"saved","pinnable","count","tasks","Tasks",{},"Changes",{},{"_201":194,"_124":213,"_28":194,"_204":258,"_154":206,"_207":26,"_208":206},{"_201":210,"_124":211,"_28":210,"_204":257,"_154":206,"_207":26,"_208":206},{"_201":202,"_124":203,"_28":202,"_204":256,"_154":206,"_207":26,"_208":206},{"_201":253,"_124":254,"_28":253,"_204":255,"_154":26,"_207":26,"_208":206},{"_201":250,"_124":251,"_28":250,"_204":252,"_154":26,"_207":26,"_208":206},{"_201":190,"_124":248,"_28":183,"_204":249,"_154":26,"_207":26,"_208":206},{"_201":191,"_124":245,"_28":246,"_204":247,"_154":26,"_207":26,"_208":206},{"_201":188,"_124":243,"_28":188,"_204":244,"_154":26,"_207":26,"_208":206},{"_201":239,"_124":240,"_28":241,"_204":242,"_154":26,"_207":26,"_208":206},{"_201":179,"_124":237,"_28":179,"_204":238,"_154":26,"_207":26,"_208":26},{"_201":234,"_124":235,"_28":234,"_204":236,"_154":26,"_207":26,"_208":26},{"_201":231,"_124":232,"_28":231,"_204":233,"_154":26,"_207":26,"_208":26},{"_201":228,"_124":229,"_28":228,"_204":230,"_154":26,"_207":26,"_208":26},"decisions","Decisions",{},"changelog","Changelog",{},"roadmap","Roadmap",{},"Documents",{},"activity","Activity","insights",{},"Releases",{},"Deployments","automations/deployments",{},"Workflows",{},"discussions","Discussions",{},"goals","Goals",{},{},{},{},"groups","user","agents",[],"now",1794570957361,"sidebar","expanded"]