Magically turn markdown file into static website.
Last updated 4 years ago by rem .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install magi 
SYNC missed versions from official npm registry.


NPM version NPM downloads Build Status donate

The simplest way to build website for your OSS project.


yarn global add magi
# or npm 
npm i -g magi



# site name

> site description

## section title

> section description

section body content, **looks not bad huh**.

Run magi in your terminal, open browser and you'll see:


How does it work?

# h1 is used as site name, blockquote after that will be used as site description, and all other stuffs between h1 and h2 will be put in the banner.

Here's another using developit/unfetch as example:



Add a GitHub corner ribbon

You can use html-matter to set it anywhere in your markdown file, for example, at the top of it:

<!-- @magi
github: owner/repo

Notice that it should start with @magi so that we know we need to parse it, the rest part of it is simple front-matter syntax used in Jekyll.

External stypes and scripts

To insert style and script tag with external resource:

<!-- @magi
  - ./css/custom.css
  - ./js/app.js
  - ./js/post.js


# defaults to
# run server to preview
magi [file]

# build html file
magi build [file]
# defaults to output to index.html
# but you can change it
magi build [file] --out docs/index.html


  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D


magi © egoist, Released under the MIT License.
Authored and maintained by egoist with help from contributors (list). · GitHub @egoist · Twitter @rem_rin_rin

Current Tags

  • 0.4.0                                ...           latest (4 years ago)

5 Versions

  • 0.4.0                                ...           4 years ago
  • 0.3.0                                ...           4 years ago
  • 0.2.0                                ...           4 years ago
  • 0.1.0                                ...           4 years ago
  • 0.0.0                                ...           5 years ago
Maintainers (1)
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 1
Last Month 1
Dependencies (19)
Dev Dependencies (17)
Dependents (2)

Copyright 2014 - 2016 © |