轻松记录您
灵感和创意

markdown的js语法

Markdown.js 是一个基于 JavaScript 的 Markdown 语法解析器,有几个选项,在这个项目,但都把 Markdown 到 HTML 的转换为一个单一的步骤。你通过 Markdown 和获取 HTML 故事结束。我们有一些非常特别的意见,关于如何实际的过程,其中包括:

  • 产生良好的 HTML。这意味着他们和强大的嵌套是重要的,为的是能够输出为HTML和XHTML
  • 要允许解析数据处理的中间表示(我们其实有两个,两 JsonML:降价树和HTML树)
  • 不必重写整个分析机制,很容易扩展到添加新方言
  • 有一个很好的测试套件。我们能找到的唯一的测试套件的测试大块的输入,并通过依靠完全相同的空白的原始实现输出HTML

安装
仅仅需要 Markdown 库只需要运行下面的代码

npm install markdown

可选,安装 md2html 在对你的项目中

npm install -g markdown

如果你想在浏览器中使用,你可以通过 GitHub地址 下载得到Markdown-js的源文件,然后引入到你的项目中。

<script src="js/markdown.js"></script>

使用方法:基本使用

md_content = "Hello.\n\n* This is markdown.\n* It is fun\n* Love it or leave it."
html_content = markdown.toHTML( md_content );

支持特别的其它的语法

md_content = "Vessel     | Captain\n-----------|-------------\nNCC-1701   | James T Kirk\nNCC-1701 A | James T Kirk\nNCC-1701 D | Picard";
html_content = markdown.toHTML( md_content, 'Maruku');

在 Node 中使用

var markdown = require( "markdown" ).markdown;
console.log( markdown.toHTML( "Hello *World*!" ) );

我们只正式支持 Node.js 0.10 作为我们使用的库,用于构建和测试不适用于旧版本的节点。这是因为这个模块是如此简单,没有使用任何部分的节点的接口,如果你使用前内置的版本,并找到一个错误,让我们知道,我们会尝试和修复它。

在浏览器中使用

它还适用于浏览器,这里是一个完整的例子:

<!DOCTYPE html>
<html>
  <body>
    <textarea id="text-input" oninput="this.editor.update()"
    rows="6" cols="60">Type **Markdown** here.</textarea>
    <div id="preview"> </div>
    <script src="lib/markdown.js"></script>
    <script>
      function Editor(input, preview) {
        this.update = function () {
          preview.innerHTML = markdown.toHTML(input.value);
        };
        input.editor = this;
        this.update();
      }
      var $ = function (id) { return document.getElementById(id); };
      new Editor($("text-input"), $("preview"));
    </script>
  </body>
</html>

在命令行中运行

假设你已经安装了md2html脚本(见安装,以上),你可以将Markdown到HTML:

# read from a file
md2html /path/to/doc.md > /path/to/doc.html

# or from stdin
echo 'Hello *World*!' | md2html

可选选项

如果你想要更多的控制检查文档.js文件在src/所有细节的方法和参数(包括例子!)有一天我们会得到文档生成和主持的地方更好的浏览。

同时,这里采用多步处理使维基式连接的工作填补缺失的环节,引用一个例子:

var md = require( "markdown" ).markdown,
    text = "[Markdown] is a simple text-based [markup language]\n" +
           "created by [John Gruber]\n\n" +
           "[John Gruber]: http://daringfireball.net";

// parse the markdown into a tree and grab the link references
var tree = md.parse( text ),
    refs = tree[ 1 ].references;

// iterate through the tree finding link references
( function find_link_refs( jsonml ) {
  if ( jsonml[ 0 ] === "link_ref" ) {
    var ref = jsonml[ 1 ].ref;

    // if there's no reference, define a wiki link
    if ( !refs[ ref ] ) {
      refs[ ref ] = {
        href: "http://en.wikipedia.org/wiki/" + ref.replace(/\s+/, "_" )
      };
    }
  }
  else if ( Array.isArray( jsonml[ 1 ] ) ) {
    jsonml[ 1 ].forEach( find_link_refs );
  }
  else if ( Array.isArray( jsonml[ 2 ] ) ) {
    jsonml[ 2 ].forEach( find_link_refs );
  }
} )( tree );

// convert the tree into html
var html = md.renderJsonML( md.toHTMLTree( tree ) );
console.log( html );

 

 

未经允许不得转载:坚果之云 Markdown » markdown的js语法
分享到: 更多 (0)

坚果云Markdown轻松记录您 灵感和创意

坚果云Markdown下载坚果云Markdown介绍