npm 包 hexo-renderer-marked 使用教程

简介

hexo-renderer-marked 是 Hexo 博客框架中使用的 Markdown 渲染插件。它基于 marked 实现,可以将 Markdown 文本转换为 HTML 页面。

在 Hexo 中使用 hexo-renderer-marked 插件,可以方便地创建支持 Markdown 语法的静态博客网站,同时提供了一些扩展功能,如代码高亮、表格渲染等。

安装

安装 hexo-renderer-marked 插件非常简单,只需要在终端中执行以下命令:

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

如果你使用的是 yarn 包管理器,可以执行以下命令:

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

配置

安装 hexo-renderer-marked 后,我们需要在 Hexo 的配置文件中进行相关配置。打开 _config.yml 文件,在 markdown 部分添加如下内容:

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

其中,plugins 部分可以根据需要添加其他的 markdown-it 插件;renderer 部分指定了渲染器为 marked,并设置了一些渲染选项。

使用

安装和配置完成后,我们就可以在 Hexo 中使用 hexo-renderer-marked 渲染 Markdown 文本了。例如,在文章中插入以下 Markdown 代码:

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

----------

-- --

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

-- ---

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

在页面中将会被渲染为:

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

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

-----------

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

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

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

扩展功能

hexo-renderer-marked 提供了一些扩展功能,如代码高亮、表格渲染等。下面我们来介绍一下如何使用这些功能。

代码高亮

要在 Hexo 中实现代码高亮功能,我们需要先安装 prismjs 或 highlight.js 等代码高亮库,然后在 Hexo 的主题配置文件中进行相关配置。

以使用 prismjs 为例,首先在终端中执行以下命令安装 prismjs:

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

然后在 Hexo 的主题配置文件中添加如下代码:

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

其中,plugins 部分可以根据需要添加其他的插件;autoloader 部分指定了自动加载的语言类型。

在文章中使用以下代码块,就可以实现代码高亮效果了:

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

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

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

猜你喜欢

  • npm包default-user-agent使用教程

    在前端开发中,我们经常需要获取或者修改http请求的user-agent信息。default-user-agent是一款方便的npm包,可以帮助我们快速地获取和修改http请求的user-agent信...

    6 年前
  • npm 包 is-class-hotfix 使用教程

    前言 在前端开发中,我们常常需要判断 DOM 元素是否包含某个 class,以便进行相应的逻辑处理。而使用 element.classList.contains(className) 方法可以完成此操...

    6 年前
  • npm 包 is-type-of 使用教程

    在前端开发中,经常需要判断数据类型。is-type-of 是一个方便实用的 NPM 包,可以轻松地对 JavaScript 变量和对象进行数据类型检测。本文将详细介绍如何使用 is-type-of 进...

    6 年前
  • npm 包 coffee 使用教程

    什么是 Coffee? Coffee 是一个 JavaScript 的预处理器,它允许开发者使用类似于 Ruby 或 Python 等语言中的语法来编写 JavaScript 代码。

    6 年前
  • npm 包 muk 使用教程

    简介 muk 是一个轻量级的 mock 数据生成器,它可以用于前端开发中的单元测试和 API 开发过程中的数据模拟。该工具提供了灵活的 API 和可定制的规则,能够帮助程序员在测试和开发过程中更快捷地...

    6 年前
  • npm 包 urllib 使用教程

    在前端开发中,我们经常会用到各种网络请求。而 urllib 是一个 Node.js 的 HTTP 请求库,可以帮助我们方便地进行网络请求。本文将详细介绍如何使用 urllib 进行 HTTP 请求。

    6 年前
  • npm 包 connect-multiparty 使用教程

    在 Node.js 的 Web 应用开发中,文件上传是一个常见的需求。connect-multiparty 是一个 Express 中间件(Middleware),它可以方便地处理文件上传,并将上传后...

    6 年前
  • npm包formstream使用教程

    简介 formstream是一个流式的表单数据构建工具,它可以帮助我们方便地构建和发送表单数据请求。这个npm包通常用于前端与后端之间的文件上传操作,是非常实用的一个工具。

    6 年前
  • npm 包 buffer-type 使用教程

    在前端开发中,经常需要处理二进制数据。Node.js提供了Buffer模块来处理这些数据。而npm包buffer-type则提供了更加方便的方式来处理不同类型的二进制数据。

    6 年前
  • npm 包 pedding 使用教程

    在前端开发中,我们经常需要对函数进行参数校验以及类型检查等操作。npm 包 pedding 提供了一个简单且方便的方式来完成这些任务。本文将介绍如何使用 pedding 进行参数校验,并为读者提供深入...

    6 年前
  • npm 包 qn 使用教程

    在前端开发中,我们常常需要使用云存储来存储和管理文件,例如图片、视频等。而七牛云是一家提供云存储服务的公司,他们提供了一个 npm 包叫做 qn,可以方便地在前端项目中使用七牛云存储。

    6 年前
  • npm 包 cov 使用教程

    当我们在编写 JavaScript 代码时,测试是非常重要的一环。但如何对测试进行覆盖率统计呢?这就需要使用到 cov 这个 npm 包。 什么是 cov cov 是一个开源的 npm 包,用于检测并...

    6 年前
  • npm 包 giturl 使用教程

    GitUrl 是一个 Node.js 模块,用于从 Git URL 中提取有关仓库的信息。 它可用于构建各种自动化工具和脚本,例如自动版本控制、自动发布等。 安装 可以使用 npm 来安装 GitUr...

    6 年前
  • npm包deps-regex使用教程

    在前端开发的过程中,我们通常会使用npm包来管理项目中的依赖关系。有时候我们需要找出项目中所有依赖项的版本,以确保它们与项目的其他部分兼容。这就是deps-regex这个npm包能够解决的问题。

    6 年前
  • npm 包 deprecate 使用教程

    在 Node.js 生态圈中,npm 是最受欢迎的包管理器之一。它允许开发者轻松地安装、升级和分享 JavaScript 包。然而,在项目的开发周期中,一些 npm 包可能会变得过时或不再维护。

    6 年前
  • npm 包 pino-noir 使用教程

    简介 pino-noir 是一个基于 pino 的 Node.js 日志库,它提供类似 Kibana 一样的可视化工具,用于分析和查询日志。pino-noir 的特点是可以快速、高效地处理大量数据,支...

    6 年前
  • npm包 fast-redact使用教程

    在前端开发中,对于一些敏感信息的保护是非常重要的。而npm包 fast-redact可以帮助我们快速地对敏感信息进行安全屏蔽并输出。 安装 使用npm命令安装fast-redact: --- ----...

    6 年前
  • npm 包 json-parse-safe 使用教程

    当我们在处理 JSON 数据时,经常会使用 JSON.parse() 方法将字符串转换为 JavaScript 对象。但是,由于 JSON 数据的结构和格式是不可控的,可能会导致解析失败并抛出异常。

    6 年前
  • npm包fast-json-parse使用教程

    在前端开发中,处理JSON数据是一项必不可少的任务。但是随着数据规模的增大和复杂度的提高,常规的JSON解析方法可能会出现性能瓶颈。这时候,我们可以使用npm包 fast-json-parse 来提高...

    6 年前
  • npm 包 sonic-boom 使用教程

    介绍 sonic-boom 是一个 Node.js 的库,它允许你高效地将数据写入到文件中。它的特点是可以在处理大量数据时提供非常快速和高效的性能。 sonic-boom 提供了简单而强大的 API,...

    6 年前

相关推荐

    暂无文章