用途与实际影响
这项功能怎样使用
为什么需要它
个人喜欢的大字号与薄荷色,不应该自动变成对外文件的统一风格。原版的含义也不是当前编辑器主题。
举个实际例子
同一方案先导出公司版供同事评审,再导出个人版留给自己慢慢看;两份文件的内容相同,颜色和留白不同。
最后我会得到什么
生成 -原版.pdf、-个人.pdf、-公司.pdf;正文语义没有增加虚构客户或品牌。
正常时
选择哪种版式,就生成对应的 PDF;同一份正文保持原样。
发现问题时
原文自带颜色或排版与所选样式冲突时,按本次明确选择处理,不偷偷改正文。
入口不可用或证据不足时
没有可用转换器时可以查看样式文件,但不能生成 PDF。
从哪里开始
运行 python tools/export_pdf.py --input <文档.md> --mode original,mode 也可选 personal 或 company;导出后打开 PDF 看版式。
需要准备什么
- 要导出的 Markdown
- 原版、个人或公司版的选择
- PDF 保存位置
从开始到拿到结果
- 1
工具套用选定版式
原版、个人和公司版使用不同 CSS,但正文仍来自同一份 Markdown;公司版不自动等于正式品牌规范。
- 2
由同一原文导出
工具按选定样式生成对应文件,不要求维护三份正文。
- 3
逐页核对
看实际 PDF 的文字、表格与分页后才交付。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
三份实际 PDF 验收通过关键规则与设计选择
original 是中性 Markdown;personal 是薄荷阅读;company 是克制专业呈现。
样式从外部 CSS 注入,不为换色改写正文。
没有真实公司品牌材料时,不添加假品牌或客户字样。
本模块用到的名词
- 原版
- 中性、忠实正文的 Markdown 呈现,不是复制当前编辑主题。
专业定义
同一正文,按照读者选择呈现
解决什么
正式长文仍需看页数、表格和分页;一页样例不能证明任意文档。
当前怎样实现
- export-profiles 三份 CSS 定义各自色彩、字号、标题与打印规则。original 以石墨色为主,company 使用墨蓝与灰白结构,personal 保留更宽松间距和薄荷语言。
- export_pdf.py 的 MODE_LABELS 将模式映射为中文文件后缀;空白 --output 与 Typora 展开的空字符串均当作未指定输出。
执行流程
- 1
选定同一 Markdown
- 2
按读者选择模式
- 3
应用对应 CSS
- 4
检查实际 PDF
边界
- 公司版不是任意组织的正式品牌模板。
失败与恢复
- 输出样式与预期不一致
- 核对模式和文档 style policy,再看当前实际 PDF。
真实入口
export-profiles/original.css中性样式
export-profiles/personal.css个人样式
export-profiles/company.css专业样式
如何验证
- 本次同一公开样例三种实际导出均一页,逐张查看了渲染结果。
与其他模块的关系
共享正文和转换管道,保持独立视觉语义。
