Progress Note — 2026-02-26
Session with Claude (Sonnet 4.6) covering publishing target, Mermaid support, image rendering, and link format conventions.
Decisions Made
Publishing target — MkDocs reinstated
MkDocs was briefly set aside in favor of Obsidian Publish (per the 2/24 session), but was reinstated this session. Publishing target is still not fully locked in, but MkDocs is the active path. CLAUDE.md updated accordingly.
Mermaid diagrams (#15 — Resolved)
Mermaid is the right diagramming tool for this vault. It renders natively in Obsidian
and is supported in MkDocs via pymdownx.superfences. Same ```mermaid syntax works
in both environments — write once, publish anywhere.
mkdocs.yml updated:
- Expanded
pymdownx.superfenceswith custom Mermaid fence config - Added
extra_javascriptentry for the Mermaid CDN script
Image rendering (#17 — Resolved)
Obsidian-style ![[wikilink]] image embeds do not translate reliably to MkDocs.
Standard Markdown syntax does:
Link format convention
To make images and links work reliably in both Obsidian and MkDocs:
- Wikilinks off in Obsidian settings
- Link format: “path from vault” (e.g.
[Page](Areas/Duplex/Room.md)) - Obsidian auto-updates these paths on rename/move, so they are not fragile
The ezlinks plugin handles page wikilinks for MkDocs; with wikilinks off, standard
paths are generated that MkDocs can resolve without a plugin.
Frontier Fiber Modem.md updated manually to use standard Markdown image syntax.
CLAUDE.md updated with a new “Link format convention” section.
To-Do Items Added
| # | Task |
|---|---|
| 18 | Nodes in breadcrumb trails are not links |
| 19 | Ignore MD045 — images should have alt text |
Tooling Note
Learned that Claude Code stores full session history as .jsonl files under
~/.claude/projects/<project-path>/. Useful for recovery after terminal crashes.
jq is the right tool to extract readable text from these files (not yet installed).