← Back to Skills Marketplace
danielefavi

Bookify - Convert Markdown to PDF or EPUB

by Dan · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
124
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install bookify
Description
Convert Markdown files to styled PDF or EPUB ebook using md-bookify. Use when the user wants to generate a PDF document or EPUB ebook from markdown content o...
README (SKILL.md)

Convert Markdown to PDF or EPUB

Use the md-bookify npm package via npx to convert Markdown files to styled PDF documents or EPUB ebooks.

Interpreting Arguments

  • If $ARGUMENTS contains a file path (ends in .md or .markdown), convert that file
  • If $ARGUMENTS includes pdf or epub, use that format (default: PDF)
  • If $ARGUMENTS is descriptive (e.g. "convert the README to elegant PDF"), parse the intent
  • If no file is specified, use Glob to find markdown files and ask which to convert

PDF Conversion

npx [email protected] \x3Cinput.md> [options]

Options:

  • -o, --output \x3Cpath> — Output PDF file path (default: same name with .pdf extension)
  • -t, --title \x3Ctitle> — Document title (default: filename)
  • --author \x3Cname> — Author name
  • -f, --format \x3Cformat> — Page format: A4 (default), Letter, Legal
  • -s, --style \x3Cname> — Style name or path to .css file (see Styles below)
  • --landscape — Landscape orientation (good for wide tables or code)
  • --margin-top \x3Cmargin> — Top margin (e.g. 20mm)
  • --margin-right \x3Cmargin> — Right margin
  • --margin-bottom \x3Cmargin> — Bottom margin
  • --margin-left \x3Cmargin> — Left margin

EPUB Conversion

npx [email protected] epub \x3Cinput.md> [options]

Options:

  • -o, --output \x3Cpath> — Output EPUB file path (default: same name with .epub extension)
  • -t, --title \x3Ctitle> — Document title (default: filename)
  • --author \x3Cname> — Author name
  • --language \x3Ccode> — Language code (default: en)
  • --publisher \x3Cname> — Publisher metadata
  • --description \x3Ctext> — Book description metadata
  • --cover \x3Cpath> — Path to cover image file

Important: EPUB ignores --style, --format, --landscape, and --margin-* flags — those are PDF-only.

Built-in Styles (PDF only)

Style Description
default Clean, modern sans-serif styling
serif Traditional book appearance with serif fonts
elegant Refined typography with tasteful spacing
eink Optimized for e-ink displays, high contrast
eink-serif Serif variant optimized for e-ink readers

Use with -s: npx [email protected] file.md -s elegant

You can also pass a path to any .css file: npx [email protected] file.md -s ./custom.css

Supported Markdown Features

  • GitHub Flavored Markdown (tables, task lists, strikethrough)
  • Fenced code blocks with syntax highlighting (TypeScript, JavaScript, Python, Go, Rust, Java, Bash, JSON, CSS, HTML, YAML, SQL, Diff)
  • KaTeX math: $inline$ and $$block$$
  • Images with relative paths (resolved from source file directory)

Error Recovery

  • Chromium not found: Run npx puppeteer@24 browsers install chrome
  • File not found: Verify the path exists. Use Glob to search for markdown files if needed.
  • Node version: Requires Node >= 20

Examples

# Basic PDF
npx [email protected] README.md

# Styled PDF with author
npx [email protected] report.md -s elegant --author "Jane Doe" -o output/report.pdf

# US Letter format, landscape
npx [email protected] data.md -f Letter --landscape

# EPUB ebook with cover
npx [email protected] novel.md epub --author "Author Name" --cover cover.jpg

# EPUB with metadata
npx [email protected] docs.md epub -t "User Guide" --publisher "Acme Corp" --description "Complete user guide"
Usage Guidance
This skill is coherent for converting Markdown to PDF/EPUB, but it runs npm packages via npx at runtime. Before using it, verify the [email protected] package reputation and source (check the npm package page and recent release notes), ensure the execution environment has Node >= 20 and is trusted, and consider running conversions in a sandboxed or limited-permission environment. If you prefer not to fetch code at runtime, preinstall the package versions you trust on the host and ensure Chromium is available to avoid on-demand downloads.
Capability Assessment
Purpose & Capability
The name/description say 'convert Markdown to PDF or EPUB using md-bookify' and the instructions explicitly invoke npx [email protected] and (when needed) npx puppeteer to install Chromium. Required tools/paths/credentials are consistent with that purpose.
Instruction Scope
SKILL.md only tells the agent to locate/read Markdown files (via Glob/Read) and run md-bookify (and optionally puppeteer to install Chromium). These actions are proportionate to converting markdown files; there are no instructions to access unrelated system files, credentials, or external endpoints beyond npm-driven package fetches and the normal package runtime behavior.
Install Mechanism
This is an instruction-only skill with no install spec, but it relies on npx to fetch and execute [email protected] and puppeteer@24 at runtime from the npm registry. Fetching and executing packages on-demand is coherent for this task but carries typical supply-chain risk (remote code execution from npm). The SKILL.md pins versions, which reduces some risk, but users should still verify the package and version.
Credentials
No environment variables or secrets are requested. The only environmental requirements are Node >= 20, ability to run npx, and (optionally) downloading Chromium via puppeteer. Those are appropriate for running an npm-based converter and for rendering PDFs.
Persistence & Privilege
The skill is not always-enabled, doesn't request persistent system-wide changes, and doesn't ask to modify other skills' configs. It will run packages at execution time but does not claim elevated or persistent privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bookify
  3. After installation, invoke the skill by name or use /bookify
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Updated to use md-bookify version 2.2.1 and puppeteer version 24 for improved compatibility and features. - The Bash commands now explicitly specify [email protected] and puppeteer@24. - Added a source link to the npm package in the skill description. - All usage instructions and example commands updated to reference the new package versions.
v1.0.0
- Initial release of the "bookify" skill. - Converts Markdown files to styled PDF or EPUB using the md-bookify npm package. - Supports flexible input: specify file, format, or descriptive intent. - Includes custom output options, styling, and metadata for both PDF and EPUB. - Built-in error recovery for missing files, dependencies, and node version requirements.
Metadata
Slug bookify
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Bookify - Convert Markdown to PDF or EPUB?

Convert Markdown files to styled PDF or EPUB ebook using md-bookify. Use when the user wants to generate a PDF document or EPUB ebook from markdown content o... It is an AI Agent Skill for Claude Code / OpenClaw, with 124 downloads so far.

How do I install Bookify - Convert Markdown to PDF or EPUB?

Run "/install bookify" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Bookify - Convert Markdown to PDF or EPUB free?

Yes, Bookify - Convert Markdown to PDF or EPUB is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Bookify - Convert Markdown to PDF or EPUB support?

Bookify - Convert Markdown to PDF or EPUB is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Bookify - Convert Markdown to PDF or EPUB?

It is built and maintained by Dan (@danielefavi); the current version is v1.0.1.

💬 Comments