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.