Agent Skills › staskh/trading_skills › markdown-to-pdf

markdown-to-pdf

GitHub

将Markdown文件转换为专业格式PDF的Python工具。支持标题、表格、代码块等语法，无需系统依赖。

.claude/skills/markdown-to-pdf/SKILL.md staskh/trading_skills

触发场景

用户请求将.md文件转为PDF 其他技能需要生成Markdown内容的PDF

安装

npx skills add staskh/trading_skills --skill markdown-to-pdf -g -y

更多选项

非标准路径

npx skills add https://github.com/staskh/trading_skills/tree/main/.claude/skills/markdown-to-pdf -g -y

不安装直接使用

npx skills use staskh/trading_skills@markdown-to-pdf

指定 Agent (Claude Code)

npx skills add staskh/trading_skills --skill markdown-to-pdf -a claude-code -g -y

安装 repo 全部 skill

npx skills add staskh/trading_skills --all -g -y

预览 repo 内 skill

npx skills add staskh/trading_skills --list

SKILL.md

Frontmatter

{
    "name": "markdown-to-pdf",
    "arguments": [
        {
            "name": "file",
            "required": true,
            "description": "Path to the input markdown file"
        },
        {
            "name": "output",
            "required": false,
            "description": "Output PDF path. Defaults to same directory and basename as the input file."
        }
    ],
    "description": "Convert a markdown file to PDF using mistune + reportlab. Use when the user wants to convert a .md file to PDF, or when another skill needs to produce a PDF from markdown output.",
    "dependencies": [
        "trading-skills"
    ],
    "user_invocable": true
}

Markdown to PDF Converter

Converts a markdown file to a professionally formatted PDF. Pure Python — no system tools required.

Dependencies

Requires two Python packages (already in pyproject.toml):

mistune>=3.2
reportlab>=4.0

Install with: uv sync (or pip install mistune reportlab)

Instructions

uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py <input.md> [output.pdf]

input.md — path to the markdown file (required)
output.pdf — output path (optional; defaults to same directory and basename as input)

Output

The script returns JSON with:

success — true or false
input — resolved absolute path of the input file
output — resolved absolute path of the generated PDF
error — error message if success is false
generated_at — NY timezone timestamp
data_delay — always "real-time"

After conversion, tell the user the output PDF path.

Examples

# Convert sandbox/report.md → sandbox/report.pdf (default output)
uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py sandbox/report.md

# Explicit output path
uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py sandbox/report.md sandbox/AAPL_Report_2026-05-20_1430.pdf