brain-pdf

Render a brain page's Markdown into a sanitized publication-quality PDF.

1|Updated May 9, 2026
One-click install
npx skills add https://github.com/weiping/gbrain-cn --skill brain-pdf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brain-pdf
Source: https://github.com/weiping/gbrain-cn/tree/main/skills/brain-pdf
Command: npx skills add https://github.com/weiping/gbrain-cn --skill brain-pdf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of turning a stored brain page (Markdown with YAML frontmatter) into a shareable, publication-quality PDF without ugly raw metadata or manual formatting work.

Core Features & Use Cases

  • Publication-quality rendering: Converts a brain page into a polished PDF with running headers and page numbers suitable for sending and archiving.
  • Brain-first correctness: Enforces that the brain page is always the source of truth and the PDF is only a rendering.
  • Readable defaults: Strips YAML frontmatter, sanitizes emoji, and avoids cover/TOC by default for a clean professional look.

Quick Start

Ask the assistant to generate a PDF for the brain page you specify, for example “make pdf from brain media/books/this-book-personalized”.

Frequently Asked Questions about brain-pdf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a brain page to PDF without including raw YAML frontmatter?

To convert a brain page to PDF without raw metadata, the tool automatically strips YAML frontmatter and sanitizes emoji during rendering. It treats the brain page as the source of truth, generating a clean, reader-ready PDF with sensible default layout settings.

What is the best way to generate a publication-quality PDF from Markdown content?

The best way to generate a publication-quality PDF from Markdown is using the gstack make-pdf binary. It renders the content with running headers and page numbers, creating a polished document suitable for sending, briefing reports, and archiving long-form content.

Does generating a PDF from a brain page require any specific binary or environment setup?

Generating a PDF from a brain page requires the gstack make-pdf binary to be available in your environment. No other dependencies or components are needed, as the tool applies sensible default layout settings to produce a sanitized, reader-ready PDF output.

Can I use this PDF rendering approach for sharing personalized brain mirrors and briefing reports?

Yes, you can use this PDF rendering approach for sharing personalized brain mirrors and producing briefing reports. The process creates portable archives of long-form content by treating the brain page as the source of truth and outputting a clean, professional document.

Why does the rendered PDF exclude the cover page and table of contents by default?

The rendered PDF excludes the cover page and table of contents by default to ensure a clean, professional look. This readable default setting prevents unnecessary formatting clutter, making the generated document immediately reader-ready for sharing and archiving.