Skip to content

Conversation

@osteele
Copy link
Owner

@osteele osteele commented Nov 23, 2025

Implements #7 (client-side rendering)

Migrate from deprecated Blackfriday to Goldmark markdown processor with math delimiter preservation. Math expressions using $...$ delimiters are preserved in HTML output for client-side rendering with MathJax 3 or KaTeX.

This implements client-side math rendering (similar to GitHub Pages). Server-side rendering (kramdown-math-katex, kramdown-math-sskatex) will be tracked separately for full Jekyll compatibility.

Changes:

  • Migrate renderers/markdown.go from Blackfriday to Goldmark
  • Add hugo-goldmark-extensions/passthrough for math delimiter preservation
  • Preserve $...$ delimiters for both inline and display math
  • Update renderers/markdown_attrs.go for Goldmark compatibility
  • Add comprehensive test suite in renderers/markdown_math_test.go
  • Create example layout with MathJax 3 configuration
  • Create example page with math usage demonstrations
  • Update README.md with math support documentation

All existing markdown features maintained (GFM, footnotes, definition lists, typographer). Compatible with Jekyll's client-side approach (manual script injection in layouts).

🤖 Generated with Claude Code

Implements #7

Migrate from deprecated Blackfriday to Goldmark markdown processor with math
delimiter preservation. Math expressions using $...$ delimiters are preserved
in HTML output for client-side rendering with MathJax 3 or KaTeX.

Changes:
- Migrate renderers/markdown.go from Blackfriday to Goldmark
- Add hugo-goldmark-extensions/passthrough for math delimiter preservation
- Preserve $...$ delimiters for both inline and display math
- Update renderers/markdown_attrs.go for Goldmark compatibility
- Add comprehensive test suite in renderers/markdown_math_test.go
- Create example layout with MathJax 3 configuration
- Create example page with math usage demonstrations
- Update README.md with math support documentation

All existing markdown features maintained (GFM, footnotes, definition lists,
typographer). Full Jekyll compatibility with manual script injection in layouts.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@osteele osteele merged commit 8188b68 into main Nov 29, 2025
4 checks passed
@osteele osteele deleted the math-support branch November 29, 2025 11:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants