Skip to content

Conversation

@osteele
Copy link
Owner

@osteele osteele commented Nov 22, 2025

No description provided.

Add kramdown-math plugin to support LaTeX mathematical notation in
markdown files, matching Jekyll/Kramdown's math rendering behavior.

Implementation details:
- Converts $$...$$ delimiters to standard LaTeX format
- Inline math: $$x$$ → \(...\) for math within text
- Display math: $$...$$ (standalone) → \[...\] for block equations
- Uses modern Kramdown output format compatible with MathJax v2, v3, and KaTeX
- Properly handles nested HTML tags and preserves document structure
- Processes HTML after markdown rendering via PostRender hook

Users enable this by adding "kramdown-math" to the plugins list in
_config.yml, then including MathJax or KaTeX JavaScript in their layouts.

Includes comprehensive test suite covering:
- Inline and display math rendering
- Mixed content scenarios
- Edge cases (empty delimiters, special chars, nested HTML)
- HTML structure preservation

Resolves: #7
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.

3 participants