id(web): footnotes are backslash-escaped on save — [^1] syntax mangled, definition orphaned

Problem

Markdown footnotes in a file opened in the id web editor are mangled on save: the footnote syntax is backslash-escaped into literal text.

Verified probe on main a2eef6f7 (standalone crate compiling the verbatim pkgs/id/src/web/markdown.rs codec from main; log in the goal's hidden_files probe-2026-10-25-2312/probe2.log):

Input:

Text with a note.[^1]

[^1]: The footnote body.

markdown_to_prosemirror treats both the reference and the definition as ordinary paragraph text (footnotes never parse as footnotes).
Save (prosemirror_to_markdown) emits:
```
Text with a note.\[^1\]

\[^1\]: The footnote body.
```
The \[ escapes mean the saved file no longer contains a footnote at all — it renders as literal [^1] characters, and the definition paragraph is orphaned plain text.

Root cause

commonmark_options() (pkgs/id/src/web/markdown.rs:67) enables strikethrough, tasklist and table extensions but not options.extension.footnotes, so comrak parses [^1] as plain text, and its CommonMark renderer escapes the brackets of text nodes on save.
Simply enabling the extension is not a fix by itself: the convert_node arm at markdown.rs:467 explicitly maps FootnoteDefinition / FootnoteReference to json!(null) — footnotes would then be silently deleted on open instead of mangled on save. The ProseMirror schema has no footnote node, so a representation decision is required (e.g. carry reference + definition as preserved raw text that re-emits verbatim, as sized images are carried through HTML forms).

Why it matters

Footnotes are standard in longer notes/docs. Today, opening a footnoted file in the web editor and saving any edit destroys every footnote in it — silently, and in a way that is hard to notice in a diff. Same silent-save-corruption class as #872/#873/#880/#881/#882.

Acceptance criteria

A markdown file with at least one footnote reference + definition round-trips open → save with the footnote still functioning as a footnote in the saved markdown (reference and definition both intact, not escaped, not deleted).
No regression to the currently passing codec tests; the strikethrough/tasklist/table extensions behave as before.
New unit tests in pkgs/id/src/web/markdown.rs cover the footnote round-trip, including a definition with more than one paragraph if the chosen representation supports it (otherwise the limitation is named in the PR).
If the chosen fix is "preserve verbatim as raw text", a re-open of the saved file must show the same preserved form (stable fixpoint, no progressive escaping).

CODE-157

🤖 Agent note · filed

Agent: new-issue-creator job
Session / ID: new-issue-creator run, 2026-10-25 23:15 CDT (America/Chicago)
Found via: filed this run
Task: footnotes mangled on save: commonmark_options (markdown.rs:67) never enables the footnote extension, so [^1] parses as plain text and the renderer escapes it to [^1]; enabling it naively would hit the markdown.rs:467 arm that drops FootnoteDefinition/Reference to null. Verified this run with a standalone crate compiling the verbatim codec from main a2eef6f (log: goal hidden_files probe-2026-10-25-2312/probe2.log). Queued for the code pilot queue (triage packet — PM representation decision needed).
Expectation: effort/m — done looks like footnote reference+definition round-tripping intact (not escaped, not deleted), with markdown.rs unit tests.
Links: n/a yet (queue packet enqueued this run)

🤖 Agent note · parked

Agent: queue worker (repo-worker-code), lane A shift
Session / ID: queue task 1144
Found via: queue claim
Task: Parked awaiting CI on PR fix(id-web): preserve footnotes in markdown codec (#945) #1013 (footnote preservation in the id web markdown codec). Implementation is complete and probe-verified; CI was 10 pass / 17 pending / 0 fail at park time.
Expectation: resume = merge PR fix(id-web): preserve footnotes in markdown codec (#945) #1013 when CI is green, verify id(web): footnotes are backslash-escaped on save — [^1] syntax mangled, definition orphaned #945 auto-closes, complete the task.
Links: PR fix(id-web): preserve footnotes in markdown codec (#945) #1013 · branch queue/1144-945-footnotes (8977b06) · probe logs hidden_files/probe-2026-10-26-1552-t1144/crate/out.log

🤖 Agent note · picked up

Agent: queue worker (repo-worker-code), lane B shift
Session / ID: queue task 1144, run 2026-10-26T21:50Z (resumed from park)
Found via: queue claim (repo-health-code-pilot)
Task: Resume id(web): footnotes are backslash-escaped on save — [^1] syntax mangled, definition orphaned #945 footnote codec fix: PR fix(id-web): preserve footnotes in markdown codec (#945) #1013 was parked awaiting CI (10 pass / 17 pending / 0 fail at park time).
Expectation: effort/xs — fresh check at pickup: all 28 PR checks PASS, head still 8977b06; merging per standing criteria, then verifying id(web): footnotes are backslash-escaped on save — [^1] syntax mangled, definition orphaned #945 auto-closes and completing the task.
Links: PR fix(id-web): preserve footnotes in markdown codec (#945) #1013 · branch queue/1144-945-footnotes

fix(id-web): preserve footnotes in markdown codec (#945) (#1013)

🤖 Agent note · done

Agent: queue worker (repo-worker-code), lane B shift
Session / ID: queue task 1144, run 2026-10-26T21:50Z
Found via: queue claim (repo-health-code-pilot)
Task: Footnote preservation in id web markdown codec — PR fix(id-web): preserve footnotes in markdown codec (#945) #1013 (comrak footnote extension + footnote node arms in both codec directions, round-trip tests).
Expectation: met — on resume, all 28 PR checks passed (incl. cargo-check, clippy, test-unit, test shards); merged PR fix(id-web): preserve footnotes in markdown codec (#945) #1013 (squash, merge commit 554dc37); this issue auto-closed by the merge.
Links: PR fix(id-web): preserve footnotes in markdown codec (#945) #1013 (merged)

fix(id): footnote_definition save arm compiles + legacy test asserts …

Navigation Menu

Repository navigation

id(web): footnotes are backslash-escaped on save — [^1] syntax mangled, definition orphaned #945

Problem

Root cause

Why it matters

Acceptance criteria

16 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

id(web): footnotes are backslash-escaped on save — [^1] syntax mangled, definition orphaned #945

Description

Problem

Root cause

Why it matters

Acceptance criteria

Activity

developing-today commented on Oct 26, 2026

dezren39 commented on Oct 26, 2026

16 remaining items

dezren39 commented on Oct 26, 2026

dezren39 commented on Oct 26, 2026

dezren39 commented on Oct 26, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions