Skip to content

Enhance markdown navigation links and reference formatting#4762

Open
Dawsine wants to merge 1 commit intoopendatalab:masterfrom
Dawsine:fix/markdown-postprocess
Open

Enhance markdown navigation links and reference formatting#4762
Dawsine wants to merge 1 commit intoopendatalab:masterfrom
Dawsine:fix/markdown-postprocess

Conversation

@Dawsine
Copy link
Copy Markdown

@Dawsine Dawsine commented Apr 9, 2026

Summary

This PR improves generated Markdown navigation and reference formatting.

Changes

  • add anchors and internal links for references, equations, figures, and tables
  • link whole single equation references such as Eq. (46), instead of linking only the parenthesized number
  • keep consecutive reference entries compact by removing blank lines between them while preserving anchors
  • add a focused unit test for markdown navigation rendering

Validation

  • py_compile passed for the modified source file and the new unit test
  • pytest passed for tests/unittest/test_markdown_navigation.py using addopts override

Notes

This PR intentionally does not include local presentation-specific postprocessing such as image centering, image renaming, or moving figures near their first textual mention.

@dosubot dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Apr 9, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@dosubot dosubot bot added the enhancement New feature or request label Apr 9, 2026
@Dawsine
Copy link
Copy Markdown
Author

Dawsine commented Apr 10, 2026

I have read the CLA Document and I hereby sign the CLA

github-actions bot added a commit that referenced this pull request Apr 10, 2026
@Dawsine
Copy link
Copy Markdown
Author

Dawsine commented Apr 10, 2026

recheck

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant