forked from Gitlink/forgeplus
120 lines
5.9 KiB
Markdown
120 lines
5.9 KiB
Markdown
# Editor.md
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
**Editor.md** : The open source embeddable online markdown editor (component), based on CodeMirror & jQuery & Marked.
|
||
|
||
### Features
|
||
|
||
- Support Standard Markdown / CommonMark and GFM (GitHub Flavored Markdown);
|
||
- Full-featured: Real-time Preview, Image (cross-domain) upload, Preformatted text/Code blocks/Tables insert, Code fold, Search replace, Read only, Themes, Multi-languages, L18n, HTML entities, Code syntax highlighting...;
|
||
- Markdown Extras : Support [ToC (Table of Contents)](https://pandao.github.io/editor.md/examples/toc.html), [Emoji](https://pandao.github.io/editor.md/examples/emoji.html), [Task lists](https://pandao.github.io/editor.md/examples/task-lists.html), [@Links](https://pandao.github.io/editor.md/examples/@links.html)...;
|
||
- Compatible with all major browsers (IE8+), compatible Zepto.js and iPad;
|
||
- Support [decode & fliter of the HTML tags & attributes](https://pandao.github.io/editor.md/examples/html-tags-decode.html);
|
||
- Support [TeX (LaTeX expressions, Based on KaTeX)](https://pandao.github.io/editor.md/examples/katex.html), [Flowchart](https://pandao.github.io/editor.md/examples/flowchart.html) and [Sequence Diagram](https://pandao.github.io/editor.md/examples/sequence-diagram.html) of Markdown extended syntax;
|
||
- Support AMD/CMD (Require.js & Sea.js) Module Loader, and Custom/define editor plugins;
|
||
|
||
[README & Examples (English)](https://pandao.github.io/editor.md/en.html)
|
||
|
||
|
||
--------
|
||
|
||
**Editor.md** 是一款开源的、可嵌入的 Markdown 在线编辑器（组件），基于 CodeMirror、jQuery 和 Marked 构建。
|
||
|
||
|
||
|
||
#### 主要特性
|
||
|
||
- 支持通用 Markdown / CommonMark 和 GFM (GitHub Flavored Markdown) 风格的语法，也可[变身为代码编辑器](https://pandao.github.io/editor.md/examples/change-mode.html)；
|
||
- 支持实时预览、图片（跨域）上传、预格式文本/代码/表格插入、代码折叠、跳转到行、搜索替换、只读模式、自定义样式主题和多语言语法高亮等功能；
|
||
- 支持 [ToC（Table of Contents）](https://pandao.github.io/editor.md/examples/toc.html)、[Emoji表情](https://pandao.github.io/editor.md/examples/emoji.html)、[Task lists](https://pandao.github.io/editor.md/examples/task-lists.html)、[@链接](https://pandao.github.io/editor.md/examples/@links.html)等 Markdown 扩展语法；
|
||
- 支持 TeX 科学公式（基于 [KaTeX](https://pandao.github.io/editor.md/examples/katex.html)）、流程图 [Flowchart](https://pandao.github.io/editor.md/examples/flowchart.html) 和 [时序图 Sequence Diagram](https://pandao.github.io/editor.md/examples/sequence-diagram.html);
|
||
- 支持[识别和解析 HTML 标签，并且支持自定义过滤标签及属性解析](https://pandao.github.io/editor.md/examples/html-tags-decode.html)，具有可靠的安全性和几乎无限的扩展性；
|
||
- 支持 AMD / CMD 模块化加载（支持 [Require.js](https://pandao.github.io/editor.md/examples/use-requirejs.html) & [Sea.js](https://pandao.github.io/editor.md/examples/use-seajs.html)），并且支持[自定义扩展插件](https://pandao.github.io/editor.md/examples/define-plugin.html)；
|
||
- 兼容主流的浏览器（IE8+）和 [Zepto.js](https://pandao.github.io/editor.md/examples/use-zepto.html)，且支持 iPad 等平板设备；
|
||
|
||
#### Examples
|
||
|
||
[https://pandao.github.io/editor.md/examples/index.html](https://pandao.github.io/editor.md/examples/index.html)
|
||
|
||
#### Download & install
|
||
|
||
[Github download](https://github.com/pandao/editor.md/archive/master.zip)
|
||
|
||
Bower install :
|
||
|
||
```shell
|
||
bower install editor.md
|
||
```
|
||
|
||
#### Usages
|
||
|
||
HTML：
|
||
|
||
```html
|
||
<link rel="stylesheet" href="editormd.min.css" />
|
||
<div id="editormd">
|
||
<textarea style="display:none;">### Hello Editor.md !</textarea>
|
||
</div>
|
||
```
|
||
|
||
> Tip: Editor.md can auto append `<textarea>` tag;
|
||
|
||
javascript:
|
||
|
||
```html
|
||
<script src="jquery.min.js"></script>
|
||
<script src="editormd.min.js"></script>
|
||
<script type="text/javascript">
|
||
$(function() {
|
||
var editor = editormd("editormd", {
|
||
path : "../lib/" // Autoload modules mode, codemirror, marked... dependents libs path
|
||
});
|
||
|
||
/*
|
||
// or
|
||
var editor = editormd({
|
||
id : "editormd",
|
||
path : "../lib/"
|
||
});
|
||
*/
|
||
});
|
||
</script>
|
||
```
|
||
|
||
Using modular script loader :
|
||
|
||
- [Using Require.js](https://github.com/pandao/editor.md/tree/master/examples/use-requirejs.html)
|
||
- [Using Sea.js](https://github.com/pandao/editor.md/tree/master/examples/use-seajs.html)
|
||
|
||
#### Dependents
|
||
|
||
- [CodeMirror](http://codemirror.net/ "CodeMirror")
|
||
- [marked](https://github.com/chjj/marked "marked")
|
||
- [jQuery](http://jquery.com/ "jQuery")
|
||
- [FontAwesome](http://fontawesome.io/ "FontAwesome")
|
||
- [github-markdown.css](https://github.com/sindresorhus/github-markdown-css "github-markdown.css")
|
||
- [KaTeX](http://khan.github.io/KaTeX/ "KaTeX")
|
||
- [prettify.js](http://code.google.com/p/google-code-prettify/ "prettify.js")
|
||
- [Rephael.js](http://raphaeljs.com/ "Rephael.js")
|
||
- [flowchart.js](http://adrai.github.io/flowchart.js/ "flowchart.js")
|
||
- [sequence-diagram.js](http://bramp.github.io/js-sequence-diagrams/ "sequence-diagram.js")
|
||
- [Prefixes.scss](https://github.com/pandao/prefixes.scss "Prefixes.scss")
|
||
|
||
#### Changes
|
||
|
||
[Change logs](https://github.com/pandao/editor.md/blob/master/CHANGE.md)
|
||
|
||
#### License
|
||
|
||
The MIT License.
|
||
|
||
Copyright (c) 2015 Pandao
|