A markdown editor with math using markdowner
Last updated 2 years ago by jdmichaud .
ISC · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install mathdown 
SYNC missed versions from official npm registry.

A markdown live editor and renderer with math formulas

Allow to live edit markdown with math (rendered by katex) and to render external markdown page containing math formulas.

Live editor and renderer

There is no common solution to manage math in markdown. Several options are available but none of them offer the elegance, practicality and ease of use that mathdown allows.


mathdown use marked for generating HTML from markdown. Thus mathdown supports CommonMark and Github flavored markdown.


Additionally, mathdown support mathematic formulas using katex. Inline and math mode are supported.

Inline mode:

Let's define the matrix `$A$`.

Math mode:

The projection then is:
$$p=A\hat x$$

The advantage of this solution is that if the markdown engine does not support math rendering, your equations remain readable as text enclosed in <code> blocks.

Run the server

Download the package through npm:

npm install mathdown

or through git

git clone
cd mathdown
npm install

Create a config file:

cat > config.yml << EOF
static_path: static/
port: 8000
template: static/template.mustache
  • static_path points to the static file path.
  • port is the web server port.
  • template is the template used to render external markdown. A sample is provided in the static folder.

Launch the server:

node index.js -c config.yml

Use mathdown

As an editor

Go to the root page of your serveur, and a basic live editor can be used to test markdown with math.

As a renderer

Once you markdown file is hosted somewhere (github, gist, bitbucket, etc), you can render it by passing a url to mathdown:

Current Tags

  • 0.1.0                                ...           latest (2 years ago)

1 Versions

  • 0.1.0                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (12)
Dev Dependencies (3)
Dependents (0)

Copyright 2014 - 2016 © |