npm 包 Marky 使用教程

什么是 Marky?

Marky 是一个用于将 Markdown 转换为 HTML 的工具。它支持 GitHub Flavored Markdown 和 CommonMark 标准,并提供了丰富的配置选项和自定义插件机制。Marky 还可以解析代码块中的语言,并集成了 Prism.js 来进行语法高亮。

安装和使用

你需要安装 Node.js 和 npm,然后使用以下命令来安装 Marky:

--- ------- -----

Marky 的使用非常简单,只需要调用 marky() 函数并传入 Markdown 字符串即可。例如,下面是一个简单的例子:

----- ----- - ----------------

----- -------- - -- ------ -------
----- ---- - ---------------

-----------------

这个例子将会输出如下的 HTML:

---------- -----------

配置选项

Marky 提供了一些配置选项,可以让你更好地控制转换过程。你可以通过传递一个可选的配置对象来设置这些选项。下面是一些常用的选项:

  • sanitize: 是否启用 HTML 标签过滤,默认为 true
  • highlightSyntax: 是否启用语法高亮,默认为 true
  • package: 在 package.json 文件中查找的配置信息。
  • plugins: 自定义插件列表,每个插件都是一个函数,接受一个 markdown-it 实例作为参数。

例如,下面是一个使用自定义插件的例子:

----- ----- - ----------------
----- -------- - ----------------------

----- -------- - -- ------ -------
----- ---- - --------------- -
  -------- ----------
--

-----------------

自定义插件

Marky 使用了 markdown-it 库来进行 Markdown 解析。你可以通过编写自己的插件来扩展或修改 Marky 的解析过程。

下面是一个简单的自定义插件,它将所有图片的 alt 属性设置为图片文件名:

-------------- - -------------------- -
  ------------------------------- - ---------------- ---- -------- ---- ----- -
    ----- ----- - -----------
    ----- --- - --------------------------------------
    ----- --- - --------------------
    ----------------------------------- - ------- ----
    ------ ------------------------ ---- --------
  -
-

你可以将这个插件传递给 Marky 的配置选项中来启用它:

----- ----- - ----------------
----- -------- - ----------------------

----- -------- - ---------- ---------------------------
----- ---- - --------------- - -------- ---------- --

-----------------

这会将 Markdown 中的图片转换为以下 HTML 代码:

------- ------------------------ --------------------

总结

本文介绍了如何使用 npm 包 Marky 将 Markdown 转换为 HTML。我们还讨论了一些配置选项和自定义插件的用法,希望这对你有所帮助。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/44971


猜你喜欢

  • npm 包 listr-verbose-renderer 使用教程

    如果你是一个前端工程师,你可能会用到 npm 来管理项目依赖。在这个过程中,你可能会发现有一些任务需要一个进度条来显示状态,例如编译代码或打包文件等。Listr 是一个非常流行的 npm 包,它可以让...

    6 年前
  • npm 包 listr-update-renderer 使用教程

    在前端开发中,我们常常需要完成一些复杂的任务,例如打包、部署等。而这些任务往往需要执行多个命令,并且命令执行的过程中,我们需要能够实时地看到命令的进度和状态。 listr-update-rendere...

    6 年前
  • npm包listr-silent-renderer使用教程

    在前端开发中,我们常常需要管理大量的代码、依赖和工具。npm是一个常用的包管理器,可以帮助我们轻松地安装、更新和卸载各种包。但是,当我们在终端执行npm install或npm update命令时,可...

    6 年前
  • npm包hook-std使用教程

    在前端开发中,我们经常需要进行命令行操作,如运行JavaScript脚本、启动服务器等。而在这些操作中,我们都需要输出一些信息,比如错误提示、进度条等等。通常情况下,我们会使用console.log等...

    6 年前
  • NPM 包 Listr 使用教程

    什么是 Listr? Listr 是一个 Node.js 模块,可以帮助你在终端中以统一的格式展示多个任务(tasks)的状态和进度。它提供了多种内置的样式和选项,也支持自定义样式和事件处理。

    6 年前
  • npm 包 parent-require 使用教程

    在前端开发中,我们经常需要引用其他模块的代码。使用 require 语法可以方便地导入其他 Javascript 模块。但是在复杂项目中,可能会涉及到多层嵌套的模块调用,而且每个模块的路径都是相对于当...

    6 年前
  • npm 包 figlet 使用教程

    在前端开发中,我们常常需要使用文字艺术来美化我们的网站或应用程序。而 npm 包 figlet 就是一个能够帮助我们生成 ASCII 艺术字体的工具。本文将提供详细的 figlet 使用教程,并包含示...

    6 年前
  • NPM包yargonaut使用教程

    yargonaut是一个Node.js命令行解析器的美化工具。它提供了丰富的主题和样式,使命令行界面更易于阅读和理解。这篇文章将介绍如何在前端开发中使用yargonaut。

    6 年前
  • npm 包 vertest 使用教程

    简介 vertest 是一个基于 Mocha 和 Chai 的测试工具,用于测试前端代码的正确性和可靠性。它可以帮助开发者快速编写测试用例,并自动运行这些测试用例以检查代码是否符合预期。

    6 年前
  • npm包lasso-marko使用教程

    简介 Lasso是一个用于前端构建的工具,可以将多个静态资源(如css、js、图片等)打包为一个或多个bundle,并通过标签插入到网页中。lasso-marko是Lasso的一个插件,可以优化Mar...

    6 年前
  • npm 包 app-root-dir 使用教程

    在前端开发中,我们经常会需要获取项目的根目录,例如用于配置文件路径的获取等。npm 包 app-root-dir 可以帮助我们方便地获取项目的根目录。本文将详细介绍该库的使用方法,并提供示例代码和指导...

    6 年前
  • npm 包 lasso-loader 使用教程

    简介 lasso-loader 是一个基于 Node.js 的 JavaScript 模块,用于将前端资源打包成依赖关系图,并生成对应的 HTML 页面。它可以帮助我们高效地管理前端资源,从而提高网站...

    6 年前
  • npm 包 raptor-objects 使用教程

    简介 raptor-objects 是一个用于 JavaScript 对象操作的工具库,它提供了一系列方便的方法来快速创建、合并、克隆和比较对象等。 安装 你可以通过 npm 来安装 raptor-o...

    6 年前
  • npm 包 raptor-detect 使用教程

    介绍 raptor-detect 是一个基于 User-Agent 字符串的前端设备检测库。它可以识别当前设备的操作系统、浏览器及其版本信息等。 在开发响应式网页和移动端应用时,了解当前用户的设备信息...

    6 年前
  • npm包raptor-css-parser使用教程

    简介 raptor-css-parser是一个基于Node.js的CSS解析器,可用于将CSS代码解析为抽象语法树(AST)以及进行其他相关操作。它支持最新的CSS规范,并具有高度的可扩展性和灵活性,...

    6 年前
  • npm 包 dissolve 使用教程

    在前端开发中,我们经常需要对字符串进行拆分和重组的操作。npm 包 dissolve 提供了一种简单而强大的方式来完成此类任务。 安装与导入 使用 npm 可以方便地安装 dissolve: --- ...

    6 年前
  • npm 包 raptor-cache 使用教程

    介绍 raptor-cache 是一个用于浏览器端的缓存库,可以帮助开发者实现对于网络请求和计算结果的缓存。它支持设置缓存过期时间、缓存最大容量等功能,并且可以自定义缓存策略。

    6 年前
  • npm 包 deamdify 使用教程

    简介 deamdify 是一款 Node.js 模块,它的作用是将 AMD(Asynchronous Module Definition)模块转换成 CommonJS(Node.js 的模块规范)模块...

    6 年前
  • npm 包 require-self-ref 使用教程

    在前端开发中,我们通常会使用 npm 包来管理前端依赖和模块。然而,在某些情况下,我们需要在一个 npm 包中引用它自己,这时候就需要使用 require-self-ref 这个包。

    6 年前
  • npm 包 lasso 使用教程

    简介 Lasso 是一个前端打包器 (bundler),用于构建优化的 JavaScript、CSS、图片等资源。它可使您的应用程序加载更快,提升性能,并允许您使用模块化开发。

    6 年前

相关推荐

    暂无文章