在前端开发中,我们会需要将文本内容渲染成 HTML 格式,Markdown 是一种非常常见的格式。而 @aboveyou00/markdown-it 是一个优秀的 Markdown 渲染工具,本文将介绍该工具的使用方法,以及常见的定制化方法。
安装
@aboveyou00/markdown-it
的安装非常简单,只需要执行以下命令即可:
npm install --save @aboveyou00/markdown-it
使用
在使用 @aboveyou00/markdown-it
之前,我们需要引入 markdown-it
:
const MarkdownIt = require('markdown-it'); const md = new MarkdownIt();
这里使用了 markdown-it
的默认设置,如果需要对渲染进行定制化,可以参考下一节的介绍。
接下来,我们就可以使用 md
对文本内容进行渲染:
const result = md.render('# Hello, world!'); console.log(result); // <h1>Hello, world!</h1>
定制化
markdown-it
提供了许多插件,可以帮助我们进行 Markdown 渲染的定制化操作,让渲染适应我们更加具体的需求。下面我们来介绍一些常见的插件。
markdown-it-emoji
markdown-it-emoji
可以将一些简单的字符串转换成表情符号,例如将 :smile:
转换成 😊。
安装:
npm install --save markdown-it-emoji
引入:
const emoji = require('markdown-it-emoji'); const md = new MarkdownIt().use(emoji);
使用:
const result = md.render('I :heart: :coffee:!'); console.log(result); // I ❤️ ☕️!
markdown-it-container
markdown-it-container
可以为某种特定的语法设置自定义渲染规则,例如将以下符号包裹起来的内容渲染成特定样式:
::: note 这是一段注意事项。 :::
安装:
npm install --save markdown-it-container
引入:
const container = require('markdown-it-container'); const md = new MarkdownIt().use(container, 'note');
使用:
const result = md.render('::: note\n这是一段注意事项。\n:::'); console.log(result); // <div class="note"><p>这是一段注意事项。</p></div>
markdown-it-anchored
markdown-it-anchored
可以为标题添加锚点,方便用户直接访问该标题所在的内容段落。
安装:
npm install --save markdown-it-anchored
引入:
const anchored = require('markdown-it-anchored'); const md = new MarkdownIt().use(anchored);
使用:
const result = md.render('# Hello, world!'); console.log(result); // <h1 id="hello-world">Hello, world!</h1>
markdown-it-highlightjs
markdown-it-highlightjs
可以为代码块添加语法高亮效果。
安装:
npm install --save markdown-it-highlightjs highlight.js
引入:
-- -------------------- ---- ------- ----- ---- - ------------------------ ----- --------- - ----------------------------------- ----- -- - --- --------------------------- - ---------- -------- ----- ----- - -- ----- -- ----------------------- - --- - ------ ----- -------------------- - ------------------- ---------- ----- --------------- ------------ - ---------------- - ----- ---- -- - ------ ----- -------------------- - ------------------------ - ---------------- - ---
使用:
const result = md.render('```javascript\nconsole.log("Hello, world!");\n```'); console.log(result); // <pre class="hljs"><code><span class="hljs-built_in">console</span>.log(<span class="hljs-string">"Hello, world!"</span>);
小结
@aboveyou00/markdown-it
是一个可以方便地将 Markdown 渲染成 HTML 的工具,且提供了丰富的插件,使得我们可以定制化渲染效果。希望本文能够帮助到需要使用 markdown-it
的读者们。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005668681e8991b448e2b9e