适用于 Openclaw 的 marknative

一个轻量级、无需浏览器的 Markdown 渲染器,使用原生绘图后端将内容转换为分页的 PNG 或 SVG 图像。

twoface2014
v1.0.0
2026年4月2日
0
698
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install marknative

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 marknative。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 marknative?

marknative 是专为 Openclaw Skills 设计的专业工具,旨在将 Markdown 内容渲染为高质量视觉格式,而无需像 Chromium 这样的无头浏览器所带来的沉重依赖。通过使用原生渲染引擎,它为从基于文本的文档生成图像提供了一种快速的服务端解决方案。

此技能非常适合需要为笔记、文章或代码片段创建视觉快照的开发人员和 AI 代理。它会自动处理分页,确保长文档被清晰地分割成多个图像文件,同时保持一致的样式和排版。

marknative 应用场景

  • 自动将 Markdown 文档转换为 PNG 图像,以便在社交平台或内部通信中轻松共享。
  • 批量将大量 Markdown 笔记导出为分页的 SVG 文件,用于高分辨率存档。
  • 在无法安装 Puppeteer 或 Playwright 的环境中,生成 Markdown 内容的服务端图像预览。
  • 在自动化的 Openclaw Skills 流水线中,从动态 Markdown 数据创建视觉资产。

marknative 工作原理

  1. 该技能接收原始 Markdown 字符串和配置选项(如所需的输出格式 PNG 或 SVG)。
  2. 它利用 marknative 库和 skia-canvas 来解析 Markdown 并计算布局定位。
  3. 内容被绘制到虚拟 canvas 上,应用分页逻辑根据需要将内容拆分为单个页面。
  4. 渲染引擎生成表示每一页的数据缓冲区数组。
  5. AI 代理或系统将这些缓冲区保存到本地文件系统或传递给后续的工作流步骤。

marknative 配置指南

要在 Openclaw Skills 环境中使用此技能,请确保已安装所需的依赖项。先检查现有安装情况:

npm ls marknative skia-canvas

如果尚未安装这些包,请使用 npm 进行安装:

npm install marknative

请注意,由于 skia-canvas 是原生依赖项,请确保您的系统架构和 Node.js 版本与预构建的二进制文件兼容。

marknative 数据架构与分类体系

marknative 技能使用结构化格式与数据进行交互,以管理分页输出和渲染选项。

属性 类型 描述
markdown string 要转换的源 Markdown 文本。
format string 输出图像类型:'png' 或 'svg'。
pages array 对象数组,每个条目表示一个渲染页面。
page.data buffer 特定页面的原始图像数据缓冲区。
painter object (可选) 用于高级布局控制的自定义绘图接口。

marknative 高级特性

  • 支持分页渲染,允许将长格式内容自动拆分到多个图像文件中。
  • 使用 skia-canvas 的无浏览器架构,与基于 Chromium 的渲染器相比,资源消耗显著降低。
  • 完全兼容 ESM 和 TypeScript,易于集成到现代 Openclaw Skills 项目中。
  • 提供自定义 painter 钩子,供需要覆盖特定 Markdown 元素默认渲染行为的用户使用。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*