npm 包 remark-containers 使用教程

概述

Markdown 是一种轻量级标记语言,很方便的为文本添加样式和结构。然而 Markdown 本身缺少对自定义的段落类型的支持。为了弥补这一缺陷,有一种灵活的解决方案是使用 remark-containers npm 包。

remark-containers 是一个使用 remark 的插件,它提供了创建自定义 Markdown 代码块的能力。使用这个插件可以更方便地为一些定义好的块添加附加的样式、语义信息和其它特定的配置。

本文将向您介绍如何安装和使用 remark-containers npm 包。

安装

remark-containers 是一个基于 npm 的插件,安装它需要先确保您已经安装了 npm。在您的项目目录下打开终端并输入以下命令安装 remark 和 remark-containers:

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

使用

完成安装后,在项目中的 markdown 文件中添加您希望使用的自定义容器。容器由名称和从两个冒号 :: 包围的一组括号组成,如下所示:

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

在上面的例子中,名称为 "info" 的自定义容器将被创建,并将 "这是一个提示框" 作为容器的内容。

配置

您还可以配置自己的容器。更改可以应用于整个容器或特定的语言。

更改容器本身

您可以直接修改容器的样式:

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

在这个例子中,我们添加了一个 bg-green 类名,它将为我们的容器添加一个绿色背景。

我们还可以通过在容器名称后增加内容字符串来为自定义容器提供任何选项:

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

在上述示例中,代码块容器现在附带一个名为 lineNumbers 的选项,其值为 true,在渲染代码块时将为其添加行号。

更改语言本身

您可以更改容器内容的语言,例如,将代码块的语言从默认的 JavaScript 更改为 TypeScript:

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

在这个例子中,我们把容器的语言选项修改为 TypeScript。remark-containers 将自动在代码块周围添加正确的语言标记(例如,<pre class="language-typescript">)以便于渲染器识别。

示例代码

让我们看一个实际的例子。考虑以下内容:

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

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

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

:::

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

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

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

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

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

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

---
--

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

在这个例子中,我们使用 unified 所提供的插件处理框架来创建解析和渲染管道。每个插件都是使用 use() 方法链接的,并按顺序处理传递过来的内容。最终,我们将渲染出一个 HTML 片段,其中包含 CSS 类名为 card 的卡片。

结论

remark-containers npm 包是一个非常有用的扩展 Markdown 语法的方法,使用它可以方便地为自定义的内容添加语义信息、样式信息和其它配置项。在合适的情况下,它可以大大提高文档的清晰度和可读性。

在您的项目中使用 remark-containers 进行 Markdown 渲染之前,最好先掌握它的知识,以便正确地使用并利用它所提供的附加功能。

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


猜你喜欢

  • npm 包 path-is-network-drive 使用教程

    前言 在前端开发过程中,我们经常会涉及到文件的路径处理问题。其中,判断路径是否为网络驱动器路径是一个很常见的需求,而 path-is-network-drive 就是一款针对此问题的 npm 包。

    4 年前
  • npm 包 path-strip-sep 使用教程

    前言 对于前端开发者而言,处理文件路径是一个必不可少的过程。我们通常会用到很多文件路径相关的 API,其中 path 模块尤为重要。在 path 模块中,有一些方法会返回具有多个路径分隔符的路径字符串...

    4 年前
  • npm 包 upath2 使用教程

    前言 在前端开发中,文件路径处理经常是必不可少的一项任务。而使用纯 JavaScript 处理路径可能会比较麻烦,这时候一个好用的 npm 包会省去很多繁琐的工作。

    4 年前
  • NPM 包 find-yarn-workspace-root2 使用教程

    前言 随着前端工程化的不断发展,我们很多的工程和项目开始使用了 Yarn 作为包管理工具,而针对 Yarn 工作区而出现的 npm 包 find-yarn-workspace-root2,可以帮助我们...

    4 年前
  • npm包 @jsdevtools/ez-spawn使用教程

    @jsdevtools/ez-spawn是一个在nodejs项目中使用的模块,它可以让你轻松地在控制台中执行shell命令,支持async/await,以及提供了更加灵活的选项配置。

    4 年前
  • npm 包 @jsdevtools/chai-exec 使用教程

    简介 在前端测试中,测试代码的正确性是非常重要的。JavaScript 测试框架 Chai 是一个流行的测试框架,它有丰富的 API 可以用来断言代码的正确性。其中,chai-exec 是一个能够简化...

    4 年前
  • npm包 @jsdevtools/version-bump-prompt 使用教程

    简介 在前端开发中,我们经常需要对项目版本进行升级或者发布新的版本。这个过程需要我们手动修改 package.json 中的版本号,比较繁琐。为此,@jsdevtools/version-bump-p...

    4 年前
  • npm 包 @jsdevtools/eslint-config-modular 使用教程

    什么是 eslint-config-modular @jsdevtools/eslint-config-modular 是一个基于 ESLint 的扩展模块,拥有一套可定制的、模块化的 ESLint ...

    4 年前
  • npm 包 @types/glob-to-regexp 使用教程

    在前端开发的过程中,我们经常会用到一些 npm 包来简化我们的开发流程。@types/glob-to-regexp 就是一个方便的 npm 包,它允许我们通过 glob 语法来匹配字符串,并把 glo...

    4 年前
  • npm 包 @jsdevtools/file-path-filter 使用教程

    简介 在前端开发过程中,文件路径的处理是一个常见的需求。如何对文件路径进行过滤是一个有趣的问题。 @jsdevtools/file-path-filter 提供了一个灵活的方案,可以为开发者解决各种文...

    4 年前
  • npm 包 @jsdevtools/readdir-enhanced 使用教程

    介绍 在前端开发中,我们经常需要遍历文件夹和读取文件。 readdir 是 Node.js 中一个强大的模块,可以帮助我们读取文件夹中的文件和子文件夹。但是,它存在一些限制,比如它只能读取单个子文件夹...

    4 年前
  • npm 包 @elastic/eslint-config-kibana 使用教程

    前言 在前端开发中,代码规范是非常重要的,可以使代码更加易读、易于维护以及更加统一。工欲善其事,必先利其器,所以我们需要选择好一款适合自己团队项目的代码规范工具。这篇文章主要介绍一个 npm 包 @e...

    4 年前
  • npm 包 mdn-confluence 使用教程

    在前端开发中,我们经常需要查询某个 HTML 元素、CSS 属性或 JavaScript 函数的使用方法和相关文档。在这方面,MDN(Mozilla 开发者网络)是一个非常好的资源。

    4 年前
  • NPM 包 @types/nightmare 使用教程

    在前端开发中,有时候会需要使用自动化测试工具。其中一个常用的工具是 Nightmare.js,它是一个高级的异步驱动模拟浏览器的库,类似于 PhantomJS,可以模拟鼠标、键盘操作,也可以用于抓取 ...

    4 年前
  • npm 包 ast-metadata-inferer 使用教程

    AST-Metadata-Inferer 是一款非常实用的 NPM 包,它可以帮助开发者在更高效地开发前端项目时搜集和收集代码元数据并进行加工,使代码更规范、更易于管理。

    4 年前
  • npm 包 is-urlsearchparams 使用教程

    随着 web 应用的日益复杂,前端开发中经常需要对 URL 中的查询参数进行操作。而浏览器自带的 URLSearchParams API 也存在兼容性问题。因此,npm 有一个名为 is-urlsea...

    4 年前
  • npm 包 incomplete-symbol 使用教程

    在前端开发中,我们可能会遇到需要输入特定的命令或者关键字的情况。但是有时候我们会输入错误或者不完整的命令,这样会导致程序无法正确执行。这时候,我们可以使用 npm 包 incomplete-symbo...

    4 年前
  • npm 包 incomplete-url 使用教程

    前言 在 Web 开发过程中,前端经常会涉及到 URL 的操作。而 URL 中的查询参数通常是实现各种功能的关键。但是在实际开发中,我们可能会遇到一些非常棘手的问题,例如 URL 中的查询参数不完整,...

    4 年前
  • npm 包 badwords-list 使用教程

    开发一个网站或应用中,需要考虑到用户输入内容的安全,其中一个重要的问题就是过滤掉使用不当语言或含有攻击性词汇的内容。npm 包 badwords-list 能够实现这一功能,本文将详细介绍 npm 包...

    4 年前
  • npm 包 bad-words 使用教程

    在前端开发中,处理文字输入的场景经常出现。有时需要对用户输入进行过滤、屏蔽敏感词,这时候 npm 上的 bad-words 包就派上了用场。本文将介绍 bad-words 的使用方法及其指导意义。

    4 年前

相关推荐

    暂无文章