Repository navigation
After upgrading to 0.0.55, build fails with false-positive "unresolved link reference" warnings for code and diagram blocks #866
Copy link
Copy link
Closed
Labels
bugIssue reports a bugIssue reports a bugresolvedIssue is resolved, yet unreleased if openIssue is resolved, yet unreleased if open
Description
Context
Zensical: 0.0.55 (0.0.54 unaffected)
OS: macOS (Darwin 25.6.0)
Command: zensical build --clean --strict
Bug description
After upgrading from zensical 0.0.54 to 0.0.55, zensical build --strict fails with unresolved link reference warnings.
In my repo, it means hundreds of warnings. Every single one is false, since before the update the same build passed cleanly.
The flagged text is square-bracket syntax inside inline code spans, fenced code blocks, or diagram code blocks.
Some anonymized examples:
Inline code with brackets is flagged:
const credentials = await httpAuth.credentials(request, { allow: ['user'] });
A fenced JS block is flagged:
const MOCK_TODO = [
{ id: '1', title: 'Todo 1' },
]; A Mermaid diagram is flagged:
graph TD
subgraph Config[<strong>Configuration</strong>]
YAML[YAML configuration files<br/><code>data/bot_protection.yaml</code>]
end
A Graphviz/dot (kroki) block is flagged:
digraph {
node [fontname="Helvetica-Bold", fontsize=15];
} A PlantUML state-diagram block is flagged:
[*] --> Access_request_submission #lightgrey Related links
Reproduction
Steps to reproduce
- Upgrade to 0.0.55.
- Run zensical build --clean --strict against a docs tree containing Markdown like the minimal examples shown.
- Observe warnings pointing at bracketed content inside backticks or fenced/diagram code blocks.
- Downgrade to 0.0.54 and rebuild the same tree. The build succeeds.
Browser
No response
Before submitting
- I have read and followed the bug reporting guidelines.
- I have attached links to the documentation, and possibly related issues.
- I assure that I have removed all customizations before submitting this bug report.
- I have attached a .zip file with a minimal reproduction.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
bugIssue reports a bugIssue reports a bugresolvedIssue is resolved, yet unreleased if openIssue is resolved, yet unreleased if open
Activity
fix: regression reporting unresolved references (#866)
squidfunk commentedon Aug 17, 2026
Thanks for reporting! Fixed in 9973ac9. Please note that
unresolved_referencesis deprecated, so we can't guarantee that further false positives are still present. We investigate each false positive for viability, and fix those that are relatively contained. Zensical Studio contains our new production-grade Rust-based Python Markdown compatible parser, which we'll also release later this year.pan-marchewka commentedon Aug 17, 2026
@squidfunk Thank you! Looking forward to the new parser. As for Zensical Studio, I use IntelliJ IDEA, so it's not for me, I'm afraid :-).
squidfunk commentedon Aug 17, 2026
@pan-marchewka we'll bring Zensical Studio to JetBrains IDEs soon☺️
squidfunk commentedon Aug 18, 2026
Released as part of Zensical 0.0.56.