npm 包 react-markmirror 使用教程

阅读时长 4 分钟读完

简介

react-markmirror 是一个 React 组件,用于在前端渲染 Markdown。它基于 marked 包,可以支持多种扩展功能,例如代码高亮、表格、目录等。通过 react-markmirror,我们可以方便地在前端渲染 Markdown,使其更加美观、易读。本文将对 react-markmirror 的使用进行详细介绍,并给出实际示例。

安装

安装 react-markmirror 非常简单,只需执行以下命令:

使用

安装完成后,在项目中引用:

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

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

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

上述代码将展示一篇包含 h1 标签的 Markdown 文章。其中,source 属性用于接收 Markdown 内容,escapeHtml 属性表示是否对 HTML 进行转义。

如果需要支持更多的扩展功能,可以使用 marked 的配置项进行设置,示例代码如下:

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

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

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

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

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

上述代码将展示一篇包含标题、列表、代码高亮等多种功能的 Markdown 文章。其中,renderer 可以对各种 Markdown 元素进行自定义渲染;gfm 表示是否支持 GitHub 风格的 Markdown 格式;tables 表示是否支持表格;breaks 表示是否支持自动断行;sanitize 表示是否使用 DOMPurify 进行 XSS 防护;smartLists 表示是否支持智能列表;smartypants 表示是否支持智能引号等符号替换;highlight 表示代码高亮的实现方式。

结语

react-markmirror 提供了一个方便的前端 Markdown 渲染解决方案。本文介绍了如何安装和使用 react-markmirror,并给出了示例代码。希望本文能够对前端开发者有所帮助。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60055fc381e8991b448dd1f0

纠错
反馈