agentsclimarketplace
Sign in

Huashu md to pdf en

Skill Biraj2004/huashu-skills-english/huashu-md-to-pdf-en

Convert Markdown documents into professional Apple-style PDF white papers. Supports full Markdown syntax (code blocks, tables, blockquotes, lists, etc.). Auto-generates cover page, table of contents, and headers/footers. Use cases: technical documentation, white papers, tutorials, reports — any Markdown document requiring professional typesetting.From its SKILL.md

Install
npx -y skills add Biraj2004/huashu-skills-english --skill huashu-md-to-pdf-en

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
  • runs commandsInstructs the agent to run 8 commands, including `python scripts/convert.py input.md` and 7 more.

SKILL.md

11.7 KB, ~2.8k tokens by cl100k_base, as published. Nobody here has run it

Markdown to PDF Skill

Convert Markdown documents into professional Apple-design-style PDF white papers.

Core Features

  1. Professional typesetting: Book-quality layout with automatic handling of page breaks and widow/orphan control
  2. Apple design language: SF font system, modern minimalist style, professional colour palette
  3. Full table of contents: Automatically extracts chapter structure, dual-column layout, clickable page jumps
  4. Complete Markdown support: Code blocks, tables, blockquotes, lists — all rendered correctly

How to Use

Basic Usage

# Convert a single file
python scripts/convert.py input.md

# Specify output filename
python scripts/convert.py input.md -o "My White Paper.pdf"

# Custom title and author
python scripts/convert.py input.md --title "Technical White Paper" --author "Huashu"

Markdown Document Requirements

Your Markdown document should follow this structure:

# Document Title

## 1. Chapter One
### 1.1 Section One
### 1.2 Section Two

## 2. Chapter Two
### 2.1 Section One

Key rules:

  • Main chapters: ## 1. Title (number + full stop + space + title)
  • Sub-sections: ### 1.1 Title (number.number + space + title)
  • This structure is required for the table of contents to generate correctly

Design Features

Cover Design

  • Light grey gradient background
  • Large title: 64pt, clean and modern
  • Subtitle and metadata information

Table of Contents Design

  • Dual-column layout, fits on one page
  • Main chapters in bold, sub-sections indented
  • Clickable links that jump to the corresponding section

Body Typesetting

  • SF font family (Apple design language)
  • Line height 1.7 for comfortable reading
  • Chapters automatically start on a new page
  • Widow and orphan control

Code Blocks

  • Light grey background + fine border
  • 8px border radius
  • SF Mono monospace font
  • Automatic page break prevention

Tables

  • Clear grid lines
  • Light grey header row
  • Automatic header repeat (for tables that span multiple pages)

Configuration Options

To customise the style, edit the CSS variables in scripts/convert.py:

# Primary colour
PRIMARY_COLOR = '#06c'      # Apple blue
TEXT_COLOR = '#1d1d1f'      # Main text black
GRAY_COLOR = '#86868b'      # Light grey

# Font sizes
COVER_TITLE_SIZE = '64pt'
H2_SIZE = '22pt'
H3_SIZE = '17pt'
BODY_SIZE = '11pt'

Frequently Asked Questions

Q: Why is the table of contents empty?

A: Ensure your Markdown uses the correct chapter format:

  • ## 1. Title instead of ## Title
  • ### 1.1 Title instead of ### Title

Q: Code blocks not displaying correctly?

A: Ensure you're wrapping with three backticks:

```python
def hello():
    print("Hello")
```text

Q: Table formatting is broken?

A: Use standard Markdown table syntax:

| Column 1 | Column 2 |

    param($m)
    $inner = $m.Groups[1].Value
    # Split by | and fix each cell separator
    $cells = $inner -split '\|'
    $fixedCells = $cells | ForEach-Object {
      $cell = ---
name: huashu-md-to-pdf
description: |
  Convert Markdown documents into professional Apple-style PDF white papers.
  Supports full Markdown syntax (code blocks, tables, blockquotes, lists, etc.).
  Auto-generates cover page, table of contents, and headers/footers.
  Use cases: technical documentation, white papers, tutorials, reports — any Markdown document requiring professional typesetting.
---

# Markdown to PDF Skill

Convert Markdown documents into professional Apple-design-style PDF white papers.

## Core Features

1. **Professional typesetting**: Book-quality layout with automatic handling of page breaks and widow/orphan control
2. **Apple design language**: SF font system, modern minimalist style, professional colour palette
3. **Full table of contents**: Automatically extracts chapter structure, dual-column layout, clickable page jumps
4. **Complete Markdown support**: Code blocks, tables, blockquotes, lists — all rendered correctly

## How to Use

### Basic Usage

```bash
# Convert a single file
python scripts/convert.py input.md

# Specify output filename
python scripts/convert.py input.md -o "My White Paper.pdf"

# Custom title and author
python scripts/convert.py input.md --title "Technical White Paper" --author "Huashu"

Markdown Document Requirements

Your Markdown document should follow this structure:

# Document Title

## 1. Chapter One
### 1.1 Section One
### 1.2 Section Two

## 2. Chapter Two
### 2.1 Section One

Key rules:

  • Main chapters: ## 1. Title (number + full stop + space + title)
  • Sub-sections: ### 1.1 Title (number.number + space + title)
  • This structure is required for the table of contents to generate correctly

Design Features

Cover Design

  • Light grey gradient background
  • Large title: 64pt, clean and modern
  • Subtitle and metadata information

Table of Contents Design

  • Dual-column layout, fits on one page
  • Main chapters in bold, sub-sections indented
  • Clickable links that jump to the corresponding section

Body Typesetting

  • SF font family (Apple design language)
  • Line height 1.7 for comfortable reading
  • Chapters automatically start on a new page
  • Widow and orphan control

Code Blocks

  • Light grey background + fine border
  • 8px border radius
  • SF Mono monospace font
  • Automatic page break prevention

Tables

  • Clear grid lines
  • Light grey header row
  • Automatic header repeat (for tables that span multiple pages)

Configuration Options

To customise the style, edit the CSS variables in scripts/convert.py:

# Primary colour
PRIMARY_COLOR = '#06c'      # Apple blue
TEXT_COLOR = '#1d1d1f'      # Main text black
GRAY_COLOR = '#86868b'      # Light grey

# Font sizes
COVER_TITLE_SIZE = '64pt'
H2_SIZE = '22pt'
H3_SIZE = '17pt'
BODY_SIZE = '11pt'

Frequently Asked Questions

Q: Why is the table of contents empty?

A: Ensure your Markdown uses the correct chapter format:

  • ## 1. Title instead of ## Title
  • ### 1.1 Title instead of ### Title

Q: Code blocks not displaying correctly?

A: Ensure you're wrapping with three backticks:

```python
def hello():
    print("Hello")
```text

Q: Table formatting is broken?

A: Use standard Markdown table syntax:

| Column 1 | Column 2 |
|----------|----------|
| Value 1  | Value 2  |

Q: How do I change the font?

A: Edit the CSS in scripts/convert.py and modify the font-family property.

Q: The generated PDF is too large?

A: Check whether there are large images — consider compressing them or using external links.

Dependency Installation

First-time use requires installing Python dependencies:

pip3 install markdown2 weasyprint

If you encounter WeasyPrint installation issues (macOS):

brew install pango
pip3 install weasyprint

Examples

Generate Technical Documentation

python scripts/convert.py tech-guide.md -o "Technical Guide.pdf"

Generate a White Paper

python scripts/convert.py whitepaper.md --title "Product White Paper" --author "Team"

Script Reference

  • scripts/convert.py — Main conversion script
  • scripts/styles.css — CSS style definitions (embedded in script)
  • templates/cover.html — Cover template (embedded in script)

Technical Implementation

This Skill uses:

  • markdown2: Markdown parsing (with extended syntax support)
  • WeasyPrint: HTML to PDF conversion (with CSS3 support)
  • Apple design system: SF fonts, professional colour palette, modern typesetting

Changelog

v1.0 (2025-12-24)

  • Initial release
  • Full Markdown syntax support
  • Apple design style
  • Automatic table of contents generation
  • Book-quality typesetting

By Huashu | AI Native Coder · Independent Developer WeChat Official Account "Huashu" | 300k+ followers | AI Tools & Productivity Flagship products: Kitty Catchlight (AppStore Paid Rankings Top 1) · Play DeepSeek with One Book .Trim() if ($cell -match '^:?-+:? | Value 1 | Value 2 |


### Q: How do I change the font?

A: Edit the CSS in `scripts/convert.py` and modify the `font-family` property.

### Q: The generated PDF is too large?

A: Check whether there are large images — consider compressing them or using external links.

## Dependency Installation

First-time use requires installing Python dependencies:

```bash
pip3 install markdown2 weasyprint

If you encounter WeasyPrint installation issues (macOS):

brew install pango
pip3 install weasyprint

Examples

Generate Technical Documentation

python scripts/convert.py tech-guide.md -o "Technical Guide.pdf"

Generate a White Paper

python scripts/convert.py whitepaper.md --title "Product White Paper" --author "Team"

Script Reference

  • scripts/convert.py — Main conversion script
  • scripts/styles.css — CSS style definitions (embedded in script)
  • templates/cover.html — Cover template (embedded in script)

Technical Implementation

This Skill uses:

  • markdown2: Markdown parsing (with extended syntax support)
  • WeasyPrint: HTML to PDF conversion (with CSS3 support)
  • Apple design system: SF fonts, professional colour palette, modern typesetting

Changelog

v1.0 (2025-12-24)

  • Initial release
  • Full Markdown syntax support
  • Apple design style
  • Automatic table of contents generation
  • Book-quality typesetting

By Huashu | AI Native Coder · Independent Developer WeChat Official Account "Huashu" | 300k+ followers | AI Tools & Productivity Flagship products: Kitty Catchlight (AppStore Paid Rankings Top 1) · Play DeepSeek with One Book ) { " $cell " } else { " $cell " } } '|' + ($fixedCells -join '|') + '|'

| Value 1 | Value 2 |


### Q: How do I change the font?

A: Edit the CSS in `scripts/convert.py` and modify the `font-family` property.

### Q: The generated PDF is too large?

A: Check whether there are large images — consider compressing them or using external links.

## Dependency Installation

First-time use requires installing Python dependencies:

```bash
pip3 install markdown2 weasyprint

If you encounter WeasyPrint installation issues (macOS):

brew install pango
pip3 install weasyprint

Examples

Generate Technical Documentation

python scripts/convert.py tech-guide.md -o "Technical Guide.pdf"

Generate a White Paper

python scripts/convert.py whitepaper.md --title "Product White Paper" --author "Team"

Script Reference

  • scripts/convert.py — Main conversion script
  • scripts/styles.css — CSS style definitions (embedded in script)
  • templates/cover.html — Cover template (embedded in script)

Technical Implementation

This Skill uses:

  • markdown2: Markdown parsing (with extended syntax support)
  • WeasyPrint: HTML to PDF conversion (with CSS3 support)
  • Apple design system: SF fonts, professional colour palette, modern typesetting

Changelog

v1.0 (2025-12-24)

  • Initial release
  • Full Markdown syntax support
  • Apple design style
  • Automatic table of contents generation
  • Book-quality typesetting

By Huashu | AI Native Coder · Independent Developer WeChat Official Account "Huashu" | 300k+ followers | AI Tools & Productivity Flagship products: Kitty Catchlight (AppStore Paid Rankings Top 1) · Play DeepSeek with One Book

What ships with it: 3 files

22.4 KB alongside SKILL.md, 1 of them executable

scripts/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.