@dualmark/converters

中文文档
0.11.0发布于 2026/08/24Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 1.6万

为Dualmark AEO框架测试了13个生产减值转换器工厂(博客、案例研究、更改日志、比较、文件、特征、词汇、整合、法律、定价、比索、工具、视频).

中文使用文档
文档目录5 节
  1. 安装
  2. 可用的转换器
  3. 使用量
  4. OpenAPI 帮助器
  5. 许可证

@ dualmark/ 转换器

为Dualmark AEO框架进行了生产测试的减值转换器工厂.

安装

bun add @dualmark/converters @dualmark/core

可用的转换器

工厂域名
apiReferenceConverterAPI 参考文献( 与 fromOpenAPI 帮助者)
blogConverter博客文章
caseStudyConverter个案研究(附有统计数据+客户引文)
changelogConverter发布笔记( Keep- a- Changgerog 分组)
compareConverter比较页面( 比较表格)
docsConverter文件页数
featureConverter与兄弟姐妹的特长/产品页、FAQ、问题/解决办法
glossaryConverter术语表(包含更多学习+词汇)
integrationConverter市场/应用程序整合清单(供应商、类别、能力)
legalConverter法律页面
pricingConverter带有分级亮点和CTA的定价表格
pseoConverter程序化的有事实的 SIO 页面+ 相关链接组
statusPageConverter公共地位/更新网页(构成部分+事件)
toolConverter独立工具
videoConverter视频页面

使用量

import { blogConverter } from "@dualmark/converters";

const convert = blogConverter({
  siteUrl: "https://example.com",
  basePath: "/blog",
  brandFooter: "## About Acme\n\nWe build widgets.",
});

const md = convert({
  id: "first-post",
  data: { title: "Hello", publishedDate: new Date(), author: "Alice" },
  body: "Long-form content.",
});

每个工厂取一个配置对象并返回一个 (entry) => string 转换器。 传过来 @dualmark/astro 收集配置或直接从自己的框架调用.

OpenAPI 帮助器

注意 OpenAPI YAML 在调用前必须解析为 JavaScript 对象 fromOpenAPI()。 。 。 .

import { fromOpenAPI, apiReferenceConverter } from "@dualmark/converters";
import { parse } from "yaml";

const spec = parse(yamlString); // You must provide a parsed JS object
const entry = fromOpenAPI(spec, "getPetById");
const md = apiReferenceConverter({ siteUrl: "https://example.com" })(entry);

许可证

Apache 2.0 (英语)

版本与发布记录

@dualmark/converters 共发布 10 个版本,首次发布于 2026/05/06;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.11.0latest2026/08/242 个月前
0.10.02026/06/184 个月前
0.8.02026/05/305 个月前
0.7.02026/05/215 个月前
0.5.22026/05/126 个月前
0.5.02026/05/076 个月前

关于 @dualmark/converters 的常见问题

@dualmark/converters 是什么?

为Dualmark AEO框架测试了13个生产减值转换器工厂(博客、案例研究、更改日志、比较、文件、特征、词汇、整合、法律、定价、比索、工具、视频).

如何安装 @dualmark/converters?

在项目目录运行 npm install @dualmark/converters,或使用 pnpm add / yarn add / bun add。

@dualmark/converters 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dualmark/converters 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@dualmark/converters 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dualmark/converters 可以商用吗?

@dualmark/converters 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dualmark/converters 的下载量有多少?

根据 npm 官方下载统计,@dualmark/converters 在 2026/10/13 – 2026/11/11 这 30 天内被下载 15,603 次,日均约 520 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dualmark/converters 还在维护吗?

最新版本 0.11.0 发布于 2026/08/24(2 个月前);至今共发布 10 个版本,其中过去 12 个月发布了 10 个;首次发布于 2026/05/06。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。