#!/usr/bin/env python3# -*- coding: utf-8 -*- PPT 转 Markdown 工具把模板 PPT (.pptx) 提取为 Marp 可用的 Markdown。 用法 python pptx_to_md.py 模板.pptx [-o 输出.md] 输出 1) 输出名.md 提取出的 Markdown每页用 --- 分隔 2) 输出名_images/ 模板中用到的图片在 md 中通过相对路径引用 说明 提取仅保留文字、表格和图片的位置信息标题按占位符/字号识别 布局、颜色、动画等版式无法 100% 还原需在生成后手工微调样式。 importosimportreimportsysfrompptximportPresentationfrompptx.enum.shapesimportMSO_SHAPE_TYPEfrompptx.utilimportEmu FRONT_MATTER--- marp: true theme: default paginate: true size: 16:9 --- PIC_EXT{image/png:.png,image/jpeg:.jpg,image/gif:.gif,image/bmp:.bmp,image/tiff:.tiff,image/x-emf:.emf,image/x-wmf:.wmf,}defrun_text(paragraph):把段落里的 run 渲染成 markdown 文本保留加粗/斜体。parts[]forruninparagraph.runs:trun.textifnott:continueifrun.font.bold:t**t**ifrun.font.italic:t*t*parts.append(t)return.join(parts)defhas_text(paragraph):returnbool(paragraph.text.strip())defis_title_shape(shape):ifnotshape.is_placeholder:returnFalsephshape.placeholder_formattry:frompptx.enum.shapesimportPP_PLACEHOLDERreturnph.typein(PP_PLACEHOLDER.TITLE,PP_PLACEHOLDER.CENTER_TITLE)exceptException:returnFalsedefslide_title(slide):优先取标题占位符否则取字体最大的首段。candidates[]forshapeinslide.shapes:ifnotshape.has_text_frame:continueforparainshape.text_frame.paragraphs:ifhas_text(para):size0forruninpara.runs:ifrun.font.size:sizemax(size,run.font.size.pt)candidates.append((para,size,is_title_shape(shape)))ifnotcandidates:returnNone,Nonetitle_cands[cforcincandidatesifc[2]]picktitle_cands[0]iftitle_candselsemax(candidates,keylambdac:c[1]or0)parapick[0]returnpara.text.strip(),pick[1]defpara_lines(shape):返回一个文本框的段落列表 [(text, level), ...]out[]forparainshape.text_frame.paragraphs:trun_text(para).strip()ifnott:continuelvlpara.levelor0out.append((t,lvl))returnoutdefbullet(t,lvl):return *lvl- tiflvlelse- tdefrender_slide(slide,index,img_dir,md_name):lines[]title,_slide_title(slide)lines.append(!-- 第 %d 页%s --%(index,(title)iftitleelse))iftitle:lines.append(## title)else:lines.append(## 第 %d 页%index)forshapeinslide.shapes:ifshape.shape_typeMSO_SHAPE_TYPE.PICTURE:picshape.image extPIC_EXT.get(pic.content_type,.img)fname%s_%d%s%(md_name,index,ext)withopen(os.path.join(img_dir,fname),wb)asf:f.write(pic.blob)lines.append(%(os.path.relpath(img_dir,os.path.dirname(os.path.abspath(__file__))).replace(\\,/),fname))continueifshape.has_table:tableshape.table rows[]forrintable.rows:cells[c.text.strip().replace(\n, )forcinr.cells]rows.append(cells)ifrows:lines.append(| | .join(rows[0]) |)lines.append(|---|*len(rows[0]))forrinrows[1:]:lines.append(| | .join(r) |)continueifshape.has_text_frame:iftitleandtitleinshape.text_frame.text.strip():continueplinespara_lines(shape)ifplines:fort,lvlinplines:lines.append(bullet(t,lvl))return\n.join(lines)defmain():iflen(sys.argv)2:print(用法: python pptx_to_md.py 模板.pptx [-o 输出.md])sys.exit(1)pptx_pathsys.argv[1]out_pathNoneif-oinsys.argv:out_pathsys.argv[sys.argv.index(-o)1]ifout_pathisNone:stemos.path.splitext(os.path.basename(pptx_path))[0]out_pathstem.mdmd_nameos.path.splitext(os.path.basename(out_path))[0]img_diros.path.join(os.path.dirname(out_path),md_name_images)os.makedirs(img_dir,exist_okTrue)prsPresentation(pptx_path)slides[]fori,slideinenumerate(prs.slides,1):slides.append(render_slide(slide,i,img_dir,md_name))mdFRONT_MATTER\n\n---\n\n.join(slides)\nwithopen(out_path,w,encodingutf-8)asf:f.write(md)print(已生成 Markdown: out_path)print(已导出图片到: img_dir)if__name____main__:main()
