Token导航 LogoToken导航

Agent Skill · 前端设计

md2book(md2book 命令行)

md2book 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

md2book 是前端设计类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为操作浏览器;许可证信息还不明确,第三方扫描已通过,按安装量在前端设计类的 10,216 个 Skill 里排第 9,806。

总安装 194周安装 8GitHub Stars 27下载 63核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:md2book(md2book 命令行)
来源仓库:https://github.com/zeroxzhang/md2book
仓库路径:skills/md2book
安装命令:
npx skills add https://github.com/zeroxzhang/md2book --skill md2book
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/zeroxzhang/md2book --skill md2book

这个 Skill 是做什么的

前端设计类 Skill 关注页面结构、视觉规范和组件写法,输出通常是可运行的界面代码。

用于处理 GitHub 仓库、Issue 和 Pull Request 协作信息。适合围绕代码变更或仓库状态进行整理分析。md2book 属于前端设计类 Skill,可作为该场景下的辅助能力补充。通过 GitHub 安装,建议核验权限范围和命令执行风险。使用前应确认维护状态及是否会触发网络请求。

可结合原始 README 了解具体操作流程。

来源仓库内路径:skills/md2book

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/zeroxzhang/md2book --skill md2book;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要操作浏览器,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

md2book 怎么安装?

在终端执行 npx skills add https://github.com/zeroxzhang/md2book --skill md2book。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

md2book 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

md2book 需要什么权限?

权限级别是操作浏览器。该 Skill 可能涉及浏览器控制能力,使用时可能读取或操作网页内容,需要在受控环境中确认权限边界。

md2book 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

md2book 用的人多吗?

公开数据是累计安装 194 次,近一周安装 8 次,下载 63 次,GitHub 27 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

md2book 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理前端设计类任务、又不想每次都手写提示词的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

前端设计类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
frontend-design

前端设计 · Codex、Claude

8,823,360126,072只读MIT通过
vercel-composition-patterns

Vercel 组合模式 · Codex、Claude

3,858,81625,893需要联网MIT通过
vercel-react-native-skills

Vercel React native skills 前端 · Codex、Claude

2,468,66425,878只读MIT通过
adapt

adapt 搜索 · Codex、Claude

2,027,04023,125操作浏览器未明确通过
bolder

bolder 分析 · Codex、Claude

2,004,28823,130只读未明确通过
md2book

md2book 命令行 · 本页

19427操作浏览器未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Markdown to Professional PDF Book Converter

将 Markdown 格式的技术书籍/教程转换为专业排版的 PDF 电子书。

何时使用

  • 用户提供 Markdown 文件路径,要求转为 PDF
  • 用户提到"导出 PDF"、"生成电子书"、"制作 PDF"
  • 用户需要书籍级别的排版输出

快速命令

node scripts/md2book.js <input.md>
node scripts/md2book.js <input.md> --theme <minimal|academic|playful>
node scripts/md2book.js <input.md> --output <path.pdf>
node scripts/md2book.js <input.md> --verbose

完整工作流程

Phase 1: 检查输入

  1. 确认用户提供了 Markdown 文件路径
  2. 检查文件是否存在
  3. 检查文件是否有 YAML frontmatter(title, author, date 等)
  4. 如果没有 frontmatter,询问用户补充关键信息(书名、作者)

Phase 2: 确认参数

向用户确认:

  • 主题风格(默认 minimal):

- minimal — 极简科技风(大量留白,黑白灰,适合技术书) - academic — 经典学术风(衬线字体,暖色纸张,稳重专业) - playful — 活泼插画风(色彩丰富,渐变装饰)

  • 输出路径(默认与 MD 文件同级目录)
  • 是否需要目录(默认生成)

Phase 3: 执行转换

cd /Users/bytedance/Documents/CC/huashu/huashu-bookwriter-skill
node scripts/md2book.js <input.md> --theme <theme> --verbose

Phase 4: 验证输出

  1. 检查 PDF 文件是否生成
  2. 验证以下项目:

- 封面正常渲染(书名、作者可见) - 版权页包含完整信息 - 目录生成正确 - 每个 # 章节从新页面开始 - 中文无乱码 - 页码连续 - 代码块/表格未被截断

  1. 如果有问题,检查错误日志并修复

输入文件格式

Markdown 文件应包含 YAML frontmatter:

---
title: 书名
subtitle: 副标题(可选)
author: 作者名
publisher: 出版社(可选)
version: v1.0
date: 2026-04-10
isbn: 978-0-000000-00-0(可选)
description: 一句话简介
---

# 第一章 引言

正文内容...

## 1.1 概述

更多内容...

支持的 Markdown 特性

  • 标准 GFM(表格、代码块、列表)
  • 代码语法高亮(highlight.js)
  • Callout 提示框:[!INFO], [!TIP], [!WARNING], [!DANGER]
  • 图片和图注
  • 引用块
  • 自动目录生成

视觉主题说明

minimal(极简科技风)

  • 纯白背景,黑白灰色调
  • 思源宋体正文 + 黑体标题
  • 简洁的装饰线条
  • 适合:技术文档、编程教程

academic(经典学术风)

  • 暖色纸张质感背景
  • 深红色强调色
  • 经典衬线字体
  • 适合:理论著作、学术专著

playful(活泼插画风)

  • 渐变彩色封面
  • 圆角卡片设计
  • 丰富的色彩变化
  • 适合:入门教程、科普读物

故障排查

中文显示为方框

  • 检查系统是否安装了思源宋体或宋体
  • macOS 自带 Songti SC 和 STSong
  • 可在 references/font-guide.md 中查看字体配置

Playwright 浏览器未安装

cd /Users/bytedance/Documents/CC/huashu/huashu-bookwriter-skill/scripts
npx playwright install chromium

依赖未安装

cd /Users/bytedance/Documents/CC/huashu/huashu-bookwriter-skill/scripts
npm install

PDF 内容为空

  • 检查 Markdown 文件编码是否为 UTF-8
  • 使用 --verbose 查看转换日志
  • 检查 frontmatter 格式是否正确

Chromium 浏览器找不到

  • 脚本会自动检测 ~/Library/Caches/ms-playwright/ 下的 Chromium
  • 如果未安装,运行 npx playwright install chromium
  • 确认安装后重新运行转换命令

相关文件

  • scripts/md2book.js — 主转换脚本
  • scripts/package.json — 依赖配置
  • assets/styles/book.css — 书籍核心样式(分页、页眉页脚)
  • assets/styles/typography.css — 中文字体排版
  • assets/styles/components.css — 表格/代码块/引用/Callout 样式
  • assets/styles/themes/ — 三套视觉主题(minimal, academic, playful)
  • references/font-guide.md — 字体配置参考

平台分布

Codex

37.73%
按下载量换算24

Claude

30.47%
按下载量换算19

Cursor

20.51%
按下载量换算13

Gemini CLI

8.99%
按下载量换算6

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

操作浏览器

该 Skill 可能涉及浏览器控制能力,使用时可能读取或操作网页内容,需要在受控环境中确认权限边界。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills