What is MMarked? What scenarios is it suitable for?

MMarked is a Markdown variant designed specifically for mathematical content writing. It inherits Markdown's readability and writability while enhancing capabilities for mathematical documentation. Suitable for online display of math and science documents, math forums and blogs, research notes, and science articles. Not suitable for documents requiring complex formatting, extensive charts, or precise layout control for print.

How to get started with MMarked?

MMarked offers multiple usage methods: Editor plugins (direct installation from VS Code and Logseq plugin marketplaces); Server-side rendering (recommended, install via npm with @mathcrowd/mmarked). After installation, use tex2svg to convert TeX to SVG and renderMarkdown to render Markdown to HTML.

What mathematical features does MMarked support?

Supports various academic environments: Theorem blocks (theorem, lemma, corollary, axiom, definition, example, etc.) with auto-numbering and cross-referencing; Solution blocks (proof, solution) with collapsible display; Mathematical formulas in both inline and block formats; Code blocks with syntax highlighting; Images with size and caption settings.

What's the difference between MMarked, Markdown, and LaTeX?

MMarked is a Markdown variant that inherits its advantages while focusing on mathematical content. It extends math-related syntax but doesn't support all HTML tags. Compared to LaTeX, Markdown aims to convert to web content while LaTeX generates print-quality PDFs. MMarked integrates LaTeX math formula support without requiring LaTeX package installation, inheriting and extending LaTeX's advantages in digital publishing.

What aspects does MMarked not handle?

MMarked doesn't handle styling (requires CSS), doesn't provide code editors or preview clients (needs website deployment or plugin usage), and isn't a website framework (requires choosing a web framework before deployment). For customization services, contact charles@mathcrowd.cn.

MMarked | The Markdown Engine Built for STEM Education

The Markdown Engine Built for STEM Education

Stop fighting with standard Markdown plugins. mmarked brings native LaTeX support, theorem blocks, and interactive solution toggles to your educational content. Lightweight, TypeScript-based, and ready for your next EdTech project.

npm i @mathcrowd/mmarked

Support compliant for non-commercial use; commercial use requires Contact us to purchase an additional license.

Why mmarked?

Writing mathematical and educational content on the web has always been hard. Standard parsers break on complex LaTeX, lack academic structures, and handle images poorly. mmarked changes that.

Native Math First

Built-in MathJax support means your formulas look professional, always.

Academic Structure

Don't hack blockquotes. Use native syntax for Theorems, Lemmas, and Proofs.

EdTech Ready

Interactive 'Show/Hide' solution blocks built right in—perfect for quizzes and courseware.

Editor Integration

VSCode Extension

Logseq Plugin

Get Extension

Core Features

Professional Math Rendering

Handles matrices, integrals, and scientific notation with ease
Seamlessly mix $inline$ math with $$block$$ equations
Intelligent footnote and equation numbering system

Structured Academic Blocks

Write course notes and papers like a pro. Dedicated syntax for academic environments with auto-numbering and cross-referencing [~id].

Theorems, Lemmas, Definitions, Propositions, Examples
Add custom titles to your blocks (e.g., Theorem 1.2 [Pythagoras])

Interactive Learning Elements

Designed for students and self-learners.

Create 'Try it yourself' sections where answers are hidden by default
Reveal proofs or step-by-step solutions with a simple toggle

Rich Media & Syntax Control

Full control over your content presentation.

Control image and video dimensions directly in Markdown
Integrated highlight.js for beautiful code snippets
Fully compatible with standard Markdown, so your legacy content still works

Developer Experience

Built for Developers, by Developers

TypeScript

Type-safe and developer-friendly

Lightweight Core

Minimal dependencies to keep your bundle size small

Universal

Runs perfectly in Node.js (SSG/SSR) and the Browser (Client-side rendering)

Extensible

Built on top of the robust marked.js architecture

Join Our Community

Get help, share ideas, and connect with other developers using mmarked

Join Discord

Report Issues

Use Cases

For Educators

Create rich course materials and lecture notes without worrying about layout breakage

For EdTech Developers

Build LMS, quiz platforms, or documentation sites with a parser designed for your specific needs

For Researchers

Draft papers and technical blogs using the syntax you love, with the rendering quality you need

Frequently Asked Questions

Quick guide to MMarked

Want to learn more technical details?

View Full Documentation

Acknowledgment

highlight.js