Skip to content

Add remark-math-extended to list of plugins - #1505

Open
duz52 wants to merge 3 commits into
remarkjs:mainfrom
duz52:patch-1
Open

duz52 wants to merge 3 commits into
remarkjs:mainfrom
duz52:patch-1

Conversation

@duz52

@duz52 duz52 commented Oct 10, 2026 •

Copy link
Copy Markdown

Initial checklist

  • I read the support docs
  • I read the contributing guide
  • I agree to follow the code of conduct
  • I searched issues and discussions and couldn’t find anything or linked relevant results below
  • I made sure the docs are up to date
  • I included tests (or that’s not needed)

Description of changes

Add remark-math-extended to the plugin list in doc/plugins.md.

The plugin supports TeX-style math delimiters (\(...\) and \[...\]) alongside dollar delimiters ($...$ and $$...$$). This is useful for Markdown content that already uses TeX-style delimiters.

It produces standard mdast math nodes and integrates with remark-rehype. The backslashDelimiters: false option preserves CommonMark escaping for backslash delimiters.

This PR only adds the plugin entry, in alphabetical order. No additional tests are needed for this documentation change.

Validation:

  • Local npm test passes with the plugin entry formatted across two lines, using Node.js 24.19.0.
  • The plugin’s own npm test also passes, including development and production tests.

This PR adds ""remark-math-extended"" (https://github.com/duz52/remark-math-extended) to the official remark plugin list.

The plugin extends "remark-math" functionality by supporting TeX-style delimiters ("\(...\)" and "\[...\]") alongside traditional dollar-sign delimiters ("$...$" and "$$...$$").

This is particularly useful for LLM-generated Markdown, where models frequently output mathematical expressions using TeX-style delimiters.

Adoption

The package has gained significant adoption, recording approximately 158,000 weekly npm downloads in September 2026.

This suggests meaningful demand for extended math delimiter support within the remark ecosystem, particularly as Markdown rendering becomes increasingly common in AI applications.

Compatibility

- Compatible with existing remark/unified pipelines
- Produces standard mdast math nodes
- Works with "rehype-katex" for rendering

Links:

- "GitHub Repository" (https://github.com/duz52/remark-math-extended)
- "npm Package" (https://www.npmjs.com/package/remark-math-extended)

This PR only updates the plugin documentation.

Signed-off-by: DUZ <70562937+duz52@users.noreply.github.com>
@github-actions github-actions Bot added the 👋 phase/new Post is being triaged automatically label Oct 10, 2026
@github-actions

This comment has been minimized.

@github-actions github-actions Bot added 🤞 phase/open Post is being triaged manually and removed 👋 phase/new Post is being triaged automatically labels Oct 10, 2026
@codecov

codecov Bot commented Oct 10, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (1146b3a) to head (3ea2fb1).

Additional details and impacted files
@@            Coverage Diff            @@
##              main     #1505   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            6         6           
  Lines          138       138           
=========================================
  Hits           138       138           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment thread doc/plugins.md Resolved

This branch has not been deployed

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

Labels

🤞 phase/open Post is being triaged manually

Development

Successfully merging this pull request may close these issues.

2 participants