marked/README.md

68 lines
1.9 KiB
Markdown
Raw Normal View History

2018-04-06 00:47:03 +00:00
<a href="https://marked.js.org">
<img width="60px" height="60px" src="https://marked.js.org/img/logo-black.svg" align="right" />
</a>
2018-02-25 23:09:11 +00:00
2018-04-05 21:15:11 +00:00
# Marked
2018-02-25 19:18:59 +00:00
2018-04-15 22:29:57 +00:00
[![npm](https://img.shields.io/npm/v/marked.svg)](https://www.npmjs.com/package/marked)
[![gzip size](http://img.badgesize.io/https://cdn.jsdelivr.net/npm/marked@0.3.19/marked.min.js?compression=gzip)](https://cdn.jsdelivr.net/npm/marked@0.3.19/marked.min.js)
[![install size](https://packagephobia.now.sh/badge?p=marked@0.3.19)](https://packagephobia.now.sh/result?p=marked@0.3.19)
[![downloads](https://img.shields.io/npm/dt/marked.svg)](https://www.npmjs.com/package/marked)
[![travis](https://travis-ci.org/markedjs/marked.svg?branch=master)](https://travis-ci.org/markedjs/marked)
2018-04-05 21:15:11 +00:00
- ⚡ built for speed
2018-04-06 20:12:17 +00:00
- ⬇️ low-level compiler for parsing markdown without caching or blocking for long periods of time
2018-04-05 21:15:11 +00:00
- ⚖️ light-weight while implementing all markdown features from the supported flavors & specifications
2018-04-06 20:12:17 +00:00
- 🌐 works in a browser, on a server, or from a command line interface (CLI)
2018-02-25 19:18:59 +00:00
2018-03-26 00:46:27 +00:00
## Demo
2018-03-27 12:44:02 +00:00
Checkout the [demo page](https://marked.js.org/demo/) to see marked in action ⛹️
2018-03-26 00:46:27 +00:00
2018-04-05 21:15:11 +00:00
## Docs
2018-03-26 00:46:27 +00:00
Our [documentation pages](https://marked.js.org) are also rendered using marked 💯
## Installation
2013-06-28 18:54:34 +00:00
2018-02-25 20:17:16 +00:00
**CLI:** `npm install -g marked`
2018-02-25 20:17:16 +00:00
**In-browser:** `npm install marked --save`
## Usage
2013-06-28 18:54:34 +00:00
2018-02-25 20:17:16 +00:00
**CLI**
2013-06-28 18:54:34 +00:00
2018-02-25 20:17:16 +00:00
``` bash
$ marked -o hello.html
hello world
^D
$ cat hello.html
<p>hello world</p>
2013-06-28 18:54:34 +00:00
```
2018-02-25 20:17:16 +00:00
**Browser**
2014-05-06 13:48:15 +00:00
```html
<!doctype html>
<html>
<head>
<meta charset="utf-8"/>
<title>Marked in the browser</title>
</head>
<body>
<div id="content"></div>
2018-03-26 00:36:41 +00:00
<script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
2014-05-06 13:48:15 +00:00
<script>
document.getElementById('content').innerHTML =
marked('# Marked in the browser\n\nRendered by **marked**.');
2014-05-06 13:48:15 +00:00
</script>
</body>
</html>
```
## License
2012-01-03 06:35:47 +00:00
Copyright (c) 2011-2018, Christopher Jeffrey. (MIT License)
2012-01-03 06:35:47 +00:00