# markdown-to-pdf **Repository Path**: han_gx/markdown-to-pdf ## Basic Information - **Project Name**: markdown-to-pdf - **Description**: 用于 markdown 转 pdf 的定制化开发, 支持页眉, 标题, pdf 插入, 标签目录, 目录 toc, 目录跳转 等功能实现 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-11-17 - **Last Updated**: 2025-11-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## 功能支持 ```shell λ python md_to_pdf_weasyprint.py --help usage: md_to_pdf_weasyprint.py [-h] [-o OUTPUT] [--no-toc] [--toc-title TOC_TITLE] [--header HEADER] [--header-left HEADER_LEFT] [--header-right HEADER_RIGHT] [--header-position {left,center,right}] [--header-underline] [--header-font-size HEADER_FONT_SIZE] [--header-font-color HEADER_FONT_COLOR] [--footer FOOTER] [--footer-left FOOTER_LEFT] [--footer-right FOOTER_RIGHT] [--footer-position {left,center,right}] [--footer-font-size FOOTER_FONT_SIZE] [--footer-font-color FOOTER_FONT_COLOR] [--no-page-number] [--page-number-format PAGE_NUMBER_FORMAT] [--page-number-position {left,center,right}] [--margin-top MARGIN_TOP] [--margin-bottom MARGIN_BOTTOM] [--margin-left MARGIN_LEFT] [--margin-right MARGIN_RIGHT] [--paper-size {A4,Letter,Legal,A3,A5}] [--no-bookmarks] [--no-h1-page-break] [--no-h2-page-break] [--cover COVER] [--watermark WATERMARK] [--watermark-font-size WATERMARK_FONT_SIZE] [--watermark-color WATERMARK_COLOR] [--watermark-rotation WATERMARK_ROTATION] [--watermark-opacity WATERMARK_OPACITY] [--watermark-position {center,top-left,top-right,bottom-left,bottom-right}] [--watermark-pages WATERMARK_PAGES] [--watermark-grid] [--watermark-grid-cols WATERMARK_GRID_COLS] [--watermark-grid-rows WATERMARK_GRID_ROWS] [--watermark-grid-spacing-x WATERMARK_GRID_SPACING_X] [--watermark-grid-spacing-y WATERMARK_GRID_SPACING_Y] [--watermark-grid-random-rotation] [--watermark-grid-rotation-range WATERMARK_GRID_ROTATION_RANGE] [--watermark-grid-position-offset WATERMARK_GRID_POSITION_OFFSET] [--watermark-grid-no-random-offset] input_file 将 Markdown 文件转换为 PDF（使用 WeasyPrint，支持 PDF 书签） positional arguments: input_file 输入的 Markdown 文件路径 options: -h, --help show this help message and exit -o, --output OUTPUT 输出的 PDF 文件路径（默认：输入文件名.pdf） --no-toc 不显示目录 --toc-title TOC_TITLE 目录标题（默认：目录） --header HEADER 页眉文本（中间位置） --header-left HEADER_LEFT 页眉左侧文本 --header-right HEADER_RIGHT 页眉右侧文本 --header-position {left,center,right} 页眉位置（默认：center，当使用--header-left或--header-right时自动启用左右布局） --header-underline 为页眉添加下划线 --header-font-size HEADER_FONT_SIZE 页眉字体大小（默认：10pt） --header-font-color HEADER_FONT_COLOR 页眉字体颜色（默认：#000000） --footer FOOTER 页脚文本 --footer-left FOOTER_LEFT 页脚左侧文本 --footer-right FOOTER_RIGHT 页脚右侧文本 --footer-position {left,center,right} 页脚位置（默认：center） --footer-font-size FOOTER_FONT_SIZE 页脚字体大小（默认：10pt） --footer-font-color FOOTER_FONT_COLOR 页脚字体颜色（默认：#000000） --no-page-number 不显示页码 --page-number-format PAGE_NUMBER_FORMAT 页码格式，可用 {page} "第 {page} 页" --page-number-position {left,center,right} 页码位置（默认：center） --margin-top MARGIN_TOP 上边距，单位 mm（默认：30） --margin-bottom MARGIN_BOTTOM 下边距，单位 mm（默认：25） --margin-left MARGIN_LEFT 左边距，单位 mm（默认：20） --margin-right MARGIN_RIGHT 右边距，单位 mm（默认：20） --paper-size {A4,Letter,Legal,A3,A5} 纸张大小（默认：A4） --no-bookmarks 不生成 PDF 书签 --no-h1-page-break 一级标题分页（默认不分页） --no-h2-page-break 二级标题分页（默认不分页） --cover COVER 封面PDF文件路径 --watermark WATERMARK 水印文本 --watermark-font-size WATERMARK_FONT_SIZE 水印字体大小（默认：48pt） --watermark-color WATERMARK_COLOR 水印颜色（默认：#cccccc） --watermark-rotation WATERMARK_ROTATION 水印旋转角度，单位度（默认：-45） --watermark-opacity WATERMARK_OPACITY 水印透明度，0-1之间（默认：0.3） --watermark-position {center,top-left,top-right,bottom-left,bottom-right} 水印位置（默认：center） --watermark-pages WATERMARK_PAGES 水印显示页面，all表示所有页面，封面页除外（默认：all） --watermark-grid 启用网格水印模式，生成多个水印覆盖整个页面 --watermark-grid-cols WATERMARK_GRID_COLS 网格水印列数（默认：4） --watermark-grid-rows WATERMARK_GRID_ROWS 网格水印行数（默认：6） --watermark-grid-spacing-x WATERMARK_GRID_SPACING_X 网格水印水平间距，单位像素（默认：150） --watermark-grid-spacing-y WATERMARK_GRID_SPACING_Y 网格水印垂直间距，单位像素（默认：100） --watermark-grid-random-rotation 为每个网格水印随机添加旋转角度 --watermark-grid-rotation-range WATERMARK_GRID_ROTATION_RANGE 网格水印随机旋转角度范围，±度数（默认：15） --watermark-grid-position-offset WATERMARK_GRID_POSITION_OFFSET 网格水印固定位置偏移量，单位像素（默认：0，即不偏移） --watermark-grid-no-random-offset 禁用网格水印位置随机偏移，使用精确网格布局 示例: # 基本用法 python md_to_pdf_weasyprint.py input.md # 自定义输出和配置 python md_to_pdf_weasyprint.py input.md -o output.pdf --header "文档标题" # 完整配置示例 python md_to_pdf_weasyprint.py input.md \ --header "文档标题" \ --footer "公司名称" \ --page-number-format "第{page}页" \ --margin-top 30 --margin-bottom 30 ``` ## 示例说明 ```shell python md_to_pdf_weasyprint.py KA200_HS100.md -o KA200_HS100.pdf ^ --header-left "SylixOS BSP SDK" ^ --header-right "HS100-KA200" ^ --header-underline ^ --footer-left "文档版本 V1.0（2025-11-14）" ^ --footer-right "版权所有©北京翼辉信息技术有限公司" ^ --header-font-size "7" ^ --header-font-color "#000000b2" ^ --footer-font-size "7" ^ --footer-font-color "#000000b2" ^ --page-number-format "第 {page} 页" ^ --margin-top 15 ^ --margin-bottom 15 ^ --no-h1-page-break ^ --no-h2-page-break ^ --cover "封面.pdf" ^ --watermark "ACOINFO" ^ --watermark-font-size "20pt" ^ --watermark-color "#888888" ^ --watermark-rotation -45 ^ --watermark-pages 'all' ^ --watermark-opacity 0.2 ^ --watermark-grid ^ --watermark-grid-cols 2 ^ --watermark-grid-rows 2 ^ --watermark-grid-position-offset 80 ^ --watermark-grid-spacing-x 250 ^ --watermark-grid-spacing-y 400 ```