AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
fix(source-to-md): keep PowerPoint Office Math as LaTeX
hugohe305011292e6cd
diff --git a/skills/ppt-master/scripts/docs/conversion.md b/skills/ppt-master/scripts/docs/conversion.mdindex ff09ec26..0f89418e 100644--- a/skills/ppt-master/scripts/docs/conversion.md+++ b/skills/ppt-master/scripts/docs/conversion.md@@ -233,6 +233,7 @@ python3 scripts/source_to_md/ppt_to_md.py template.ppsx -o notes/template.mdBehavior:- extracts slide text in reading order+- rewrites Office Math equations (`a14:m` OMML) as `$...$` inline or `$$...$$` display LaTeX, using the same converter as `.docx`- converts PowerPoint tables to Markdown tables; cell-internal line breaks become `<br>` so they cannot break the pipe-table row structure- transcribes category charts as category × series tables and scatter/bubble charts as typed X/Y[/size] point tables- preserves every readable chart dimension or series and emits `[Chart data warning: <reason>]` for missing caches/count mismatches; `[Chart data unavailable: <reason>]` is reserved for charts with no readable points (and unsupported ChartEx), so XY data is never flattened into a misleading category tablediff --git a/skills/ppt-master/scripts/source_to_md/_omml_latex.py b/skills/ppt-master/scripts/source_to_md/_omml_latex.pynew file mode 100644index 00000000..99e8f778--- /dev/null+++ b/skills/ppt-master/scripts/source_to_md/_omml_latex.py@@ -0,0 +1,192 @@+#!/usr/bin/env python3+"""+PPT Master - Office Math (OMML) to LaTeX++Convert one OMML subtree to a LaTeX string for the source converters, so Word+and PowerPoint equations reach the Markdown as `$...$` / `$$...$$`.++Usage:+ Imported by scripts/source_to_md/doc_to_md.py and ppt_to_md.py++Examples:+ _omml_to_latex(o_math_element)++Dependencies:+ None+"""++from __future__ import annotations++from xml.etree import ElementTree as ET++MATH_NS = "http://schemas.openxmlformats.org/officeDocument/2006/math"++# OMML n-ary operator chars (m:nary/m:naryPr/m:chr) → LaTeX command.+NARY_OPS = {+ "∑": r"\sum", "∏": r"\prod", "∐": r"\coprod",+ "∫": r"\int", "∬": r"\iint", "∭": r"\iiint", "∮": r"\oint",+ "⋃": r"\bigcup", "⋂": r"\bigcap", "⋁": r"\bigvee", "⋀": r"\bigwedge",+}+# OMML accent chars (m:acc/m:accPr/m:chr) → LaTeX command.+ACCENT_CMDS = {+ "̂": r"\hat", "̃": r"\tilde", "̄": r"\bar", "→": r"\vec", "⃗": r"\vec",+ "̇": r"\dot", "̈": r"\ddot", "̌": r"\check", "́": r"\acute", "̀": r"\grave",+}+++def _local_name(elem: ET.Element) -> str:+ """Return an element's local name; lxml comments and PIs have none."""+ tag = elem.tag+ return tag.rsplit("}", 1)[-1] if isinstance(tag, str) else ""+++def _m_child(elem: ET.Element, name: str) -> ET.Element | None:+ """Return the first OMML child with the given local name."""+ for child in elem:+ if _local_name(child) == name:+ return child+ return None+++def _m_pr_val(elem: ET.Element, prop: str) -> str | None:+ """Return m:val of a property inside the element's *Pr block (e.g. chr)."""+ for child in elem:+ if not _local_name(child).endswith("Pr"):+ continue+ for sub in child:+ if _local_name(sub) == prop:+ return sub.get(f"{{{MATH_NS}}}val")+ return None+++def _brace(latex: str) -> str:+ """Wrap multi-char LaTeX in braces so it binds as one super/subscript arg."""+ return latex if len(latex) <= 1 else "{" + latex + "}"+++def _omml_part(elem: ET.Element, name: str) -> str:+ """Convert a named OMML child (e/num/den/sup/sub/...) to LaTeX."""+ child = _m_child(elem, name)+ return _omml_to_latex(child) if child is not None else ""+++def _omml_run(elem: ET.Element) -> str:+ """Concatenate text from an OMML run, skipping property children."""+ return "".join(+ c.text or "" for c in elem if _local_name(c) == "t"+ )+++def _omml_children(elem: ET.Element) -> str:+ """Convert all non-property children in order (default/passthrough rule)."""+ return "".join(+ _omml_to_latex(c) for c in elem if not _local_name(c).endswith("Pr")+ )+++def _omml_matrix(elem: ET.Element, *, environment: str) -> str:+ """Convert a matrix (m:m) or equation array (m:eqArr) to a LaTeX env."""+ rows: list[str] = []+ for row in elem:+ if _local_name(row) not in ("mr", "e"):+ continue+ if _local_name(row) == "e": # eqArr stores rows as bare <m:e>+ rows.append(_omml_to_latex(row))+ continue+ cells = [_omml_to_latex(cell) for cell in row if _local_name(cell) == "e"]+ rows.append(" & ".join(cells))+ body = r" \\ ".join(rows)+ return rf"\begin{{{environment}}} {body} \end{{{environment}}}"+++def _omml_to_latex(elem: ET.Element) -> str:+ """Recursively convert one OMML element subtree to a LaTeX string.++ Unknown elements degrade to a concatenation of their children rather than+ being dropped, so rare constructs lose markup but never lose content.+ """+ local = _local_name(elem)++ if local == "t":+ return elem.text or ""+ if local == "r":+ return _omml_run(elem)+ if local in ("oMath", "oMathPara", "e", "num", "den", "sup", "sub",+ "deg", "fName", "lim", "box", "borderBox"):+ return _omml_children(elem)+ if local == "sSup":+ return _brace(_omml_part(elem, "e")) + "^" + _brace(_omml_part(elem, "sup"))+ if local == "sSub":+ return _brace(_omml_part(elem, "e")) + "_" + _brace(_omml_part(elem, "sub"))+ if local == "sSubSup":+ return (_brace(_omml_part(elem, "e"))+ + "_" + _brace(_omml_part(elem, "sub"))+ + "^" + _brace(_omml_part(elem, "sup")))+ if local == "sPre":+ return ("{}_" + _brace(_omml_part(elem, "sub"))+ + "^" + _brace(_omml_part(elem, "sup"))+ + _brace(_omml_part(elem, "e")))+ if local == "f":+ return r"\frac{" + _omml_part(elem, "num") + "}{" + _omml_part(elem, "den") + "}"+ if local == "rad":+ deg = _m_child(elem, "deg")+ body = _omml_part(elem, "e")+ deg_latex = _omml_to_latex(deg) if deg is not None and len(deg) else ""+ return rf"\sqrt[{deg_latex}]{{{body}}}" if deg_latex else rf"\sqrt{{{body}}}"+ if local == "d":+ beg = _m_pr_val(elem, "begChr")+ end = _m_pr_val(elem, "endChr")+ beg = "(" if beg is None else (beg or ".")+ end = ")" if end is None else (end or ".")+ separator = _m_pr_val(elem, "sepChr")+ separator = "|" if separator is None else separator+ separator = _latex_literal(separator)+ beg = {"{": r"\{", "}": r"\}"}.get(beg, beg)+ end = {"{": r"\{", "}": r"\}"}.get(end, end)+ inner = separator.join(_omml_to_latex(c) for c in elem if _local_name(c) == "e")+ return rf"\left{beg}{inner}\right{end}"+ if local == "nary":+ chr_ = _m_pr_val(elem, "chr") or "∫"+ op = NARY_OPS.get(chr_, chr_)+ sub, sup = _m_child(elem, "sub"), _m_child(elem, "sup")+ out = op+ if sub is not None and len(sub):+ out += "_" + _brace(_omml_to_latex(sub))+ if sup is not None and len(sup):+ out += "^" + _brace(_omml_to_latex(sup))+ return out + _brace(_omml_part(elem, "e"))+ if local == "func":+ return "\\" + _omml_part(elem, "fName").strip() + _brace(_omml_part(elem, "e"))+ if local == "limLow":+ return _brace(_omml_part(elem, "e")) + "_" + _brace(_omml_part(elem, "lim"))+ if local == "limUpp":+ return _brace(_omml_part(elem, "e")) + "^" + _brace(_omml_part(elem, "lim"))+ if local == "bar":+ cmd = r"\underline" if _m_pr_val(elem, "pos") == "bot" else r"\overline"+ return cmd + "{" + _omml_part(elem, "e") + "}"+ if local == "acc":+ cmd = ACCENT_CMDS.get(_m_pr_val(elem, "chr") or "̂", r"\hat")+ return cmd + "{" + _omml_part(elem, "e") + "}"+ if local == "groupChr":+ char = _m_pr_val(elem, "chr")+ char = "⏟" if char is None else char+ pos = _m_pr_val(elem, "pos") or "bot"+ body = _omml_part(elem, "e")+ if (char, pos) in {("⏞", "top"), ("⏟", "bot")}:+ cmd = r"\overbrace" if pos == "top" else r"\underbrace"+ return cmd + "{" + body + "}"+ cmd = r"\overset" if pos == "top" else r"\underset"+ return cmd + r"{\text{" + _latex_literal(char) + "}}{" + body + "}"+ if local == "m":+ return _omml_matrix(elem, environment="matrix")+ if local == "eqArr":+ return _omml_matrix(elem, environment="aligned")++ return _omml_children(elem)+++def _latex_literal(text: str) -> str:+ """Escape literal characters that would otherwise change LaTeX syntax."""+ escapes = {"\\": r"\backslash{}", "{": r"\{", "}": r"\}", "%": r"\%",+ "&": r"\&", "#": r"\#", "_": r"\_", "$": r"\$"}+ return "".join(escapes.get(char, char) for char in text)diff --git a/skills/ppt-master/scripts/source_to_md/doc_to_md.py b/skills/ppt-master/scripts/source_to_md/doc_to_md.pyindex 4c14a2bb..8478acd4 100644--- a/skills/ppt-master/scripts/source_to_md/doc_to_md.py+++ b/skills/ppt-master/scripts/source_to_md/doc_to_md.py@@ -44,6 +44,7 @@ if str(_SCRIPTS_DIR) not in sys.path:from console_encoding import configure_utf8_stdio # noqa: E402from _batch import run_path_batch # noqa: E402from _conversion_profile import write_conversion_profile_best_effort # noqa: E402+from _omml_latex import _m_pr_val, _omml_to_latex # noqa: E402configure_utf8_stdio()@@ -97,17 +98,6 @@ MATH_NS = DOCX_NS["m"]W_NS = DOCX_NS["w"]XML_SPACE_ATTR = "{http://www.w3.org/XML/1998/namespace}space"-# OMML n-ary operator chars (m:nary/m:naryPr/m:chr) → LaTeX command.-NARY_OPS = {- "∑": r"\sum", "∏": r"\prod", "∐": r"\coprod",- "∫": r"\int", "∬": r"\iint", "∭": r"\iiint", "∮": r"\oint",- "⋃": r"\bigcup", "⋂": r"\bigcap", "⋁": r"\bigvee", "⋀": r"\bigwedge",-}-# OMML accent chars (m:acc/m:accPr/m:chr) → LaTeX command.-ACCENT_CMDS = {- "̂": r"\hat", "̃": r"\tilde", "̄": r"\bar", "→": r"\vec", "⃗": r"\vec",- "̇": r"\dot", "̈": r"\ddot", "̌": r"\check", "́": r"\acute", "̀": r"\grave",-}# ─────────────────────────────────────────────────────────────@@ -480,163 +470,13 @@ def _manifest_entry(# mammoth drops all math content, so Word-native equations and MathType# formulas saved as Office Math (OMML) vanish from the output. This pure-Python# converter rewrites each <m:oMath> into inline `$...$` LaTeX before mammoth-# runs, so formulas survive into the Markdown in document order.+# runs, so formulas survive into the Markdown in document order. The OMML →+# LaTeX conversion itself is shared with ppt_to_md in _omml_latex.py.## Scope: OMML only. Classic MathType OLE objects (Equation.DSMT4 / MTEF binary)# carry no OMML — they expose only a WMF/EMF preview image, which mammoth still# emits as a picture. Decoding MTEF is out of scope.-def _m_child(elem: ET.Element, name: str) -> ET.Element | None:- """Return the first OMML child with the given local name."""- for child in elem:- if _local_name(child) == name:- return child- return None---def _m_pr_val(elem: ET.Element, prop: str) -> str | None:- """Return m:val of a property inside the element's *Pr block (e.g. chr)."""- for child in elem:- if not _local_name(child).endswith("Pr"):- continue- for sub in child:- if _local_name(sub) == prop:- return sub.get(f"{{{MATH_NS}}}val")- return None---def _brace(latex: str) -> str:- """Wrap multi-char LaTeX in braces so it binds as one super/subscript arg."""- return latex if len(latex) <= 1 else "{" + latex + "}"---def _omml_part(elem: ET.Element, name: str) -> str:- """Convert a named OMML child (e/num/den/sup/sub/...) to LaTeX."""- child = _m_child(elem, name)- return _omml_to_latex(child) if child is not None else ""---def _omml_run(elem: ET.Element) -> str:- """Concatenate text from an OMML run, skipping property children."""- return "".join(- c.text or "" for c in elem if _local_name(c) == "t"- )---def _omml_children(elem: ET.Element) -> str:- """Convert all non-property children in order (default/passthrough rule)."""- return "".join(- _omml_to_latex(c) for c in elem if not _local_name(c).endswith("Pr")- )---def _omml_matrix(elem: ET.Element, *, environment: str) -> str:- """Convert a matrix (m:m) or equation array (m:eqArr) to a LaTeX env."""- rows: list[str] = []- for row in elem:- if _local_name(row) not in ("mr", "e"):- continue- if _local_name(row) == "e": # eqArr stores rows as bare <m:e>- rows.append(_omml_to_latex(row))- continue- cells = [_omml_to_latex(cell) for cell in row if _local_name(cell) == "e"]- rows.append(" & ".join(cells))- body = r" \\ ".join(rows)- return rf"\begin{{{environment}}} {body} \end{{{environment}}}"---def _omml_to_latex(elem: ET.Element) -> str:- """Recursively convert one OMML element subtree to a LaTeX string.-- Unknown elements degrade to a concatenation of their children rather than- being dropped, so rare constructs lose markup but never lose content.- """- local = _local_name(elem)-- if local == "t":- return elem.text or ""- if local == "r":- return _omml_run(elem)- if local in ("oMath", "oMathPara", "e", "num", "den", "sup", "sub",- "deg", "fName", "lim", "box", "borderBox"):- return _omml_children(elem)- if local == "sSup":- return _brace(_omml_part(elem, "e")) + "^" + _brace(_omml_part(elem, "sup"))- if local == "sSub":- return _brace(_omml_part(elem, "e")) + "_" + _brace(_omml_part(elem, "sub"))- if local == "sSubSup":- return (_brace(_omml_part(elem, "e"))- + "_" + _brace(_omml_part(elem, "sub"))- + "^" + _brace(_omml_part(elem, "sup")))- if local == "sPre":- return ("{}_" + _brace(_omml_part(elem, "sub"))- + "^" + _brace(_omml_part(elem, "sup"))- + _brace(_omml_part(elem, "e")))- if local == "f":- return r"\frac{" + _omml_part(elem, "num") + "}{" + _omml_part(elem, "den") + "}"- if local == "rad":- deg = _m_child(elem, "deg")- body = _omml_part(elem, "e")- deg_latex = _omml_to_latex(deg) if deg is not None and len(deg) else ""- return rf"\sqrt[{deg_latex}]{{{body}}}" if deg_latex else rf"\sqrt{{{body}}}"- if local == "d":- beg = _m_pr_val(elem, "begChr")- end = _m_pr_val(elem, "endChr")- beg = "(" if beg is None else (beg or ".")- end = ")" if end is None else (end or ".")- separator = _m_pr_val(elem, "sepChr")- separator = "|" if separator is None else separator- separator = _latex_literal(separator)- beg = {"{": r"\{", "}": r"\}"}.get(beg, beg)- end = {"{": r"\{", "}": r"\}"}.get(end, end)- inner = separator.join(_omml_to_latex(c) for c in elem if _local_name(c) == "e")- return rf"\left{beg}{inner}\right{end}"- if local == "nary":- chr_ = _m_pr_val(elem, "chr") or "∫"- op = NARY_OPS.get(chr_, chr_)- sub, sup = _m_child(elem, "sub"), _m_child(elem, "sup")- out = op- if sub is not None and len(sub):- out += "_" + _brace(_omml_to_latex(sub))- if sup is not None and len(sup):- out += "^" + _brace(_omml_to_latex(sup))- return out + _brace(_omml_part(elem, "e"))- if local == "func":- return "\\" + _omml_part(elem, "fName").strip() + _brace(_omml_part(elem, "e"))- if local == "limLow":- return _brace(_omml_part(elem, "e")) + "_" + _brace(_omml_part(elem, "lim"))- if local == "limUpp":- return _brace(_omml_part(elem, "e")) + "^" + _brace(_omml_part(elem, "lim"))- if local == "bar":- cmd = r"\underline" if _m_pr_val(elem, "pos") == "bot" else r"\overline"- return cmd + "{" + _omml_part(elem, "e") + "}"- if local == "acc":- cmd = ACCENT_CMDS.get(_m_pr_val(elem, "chr") or "̂", r"\hat")- return cmd + "{" + _omml_part(elem, "e") + "}"- if local == "groupChr":- char = _m_pr_val(elem, "chr")- char = "⏟" if char is None else char- pos = _m_pr_val(elem, "pos") or "bot"- body = _omml_part(elem, "e")- if (char, pos) in {("⏞", "top"), ("⏟", "bot")}:- cmd = r"\overbrace" if pos == "top" else r"\underbrace"- return cmd + "{" + body + "}"- cmd = r"\overset" if pos == "top" else r"\underset"- return cmd + r"{\text{" + _latex_literal(char) + "}}{" + body + "}"- if local == "m":- return _omml_matrix(elem, environment="matrix")- if local == "eqArr":- return _omml_matrix(elem, environment="aligned")-- return _omml_children(elem)---def _latex_literal(text: str) -> str:- """Escape literal characters that would otherwise change LaTeX syntax."""- escapes = {"\\": r"\backslash{}", "{": r"\{", "}": r"\}", "%": r"\%",- "&": r"\&", "#": r"\#", "_": r"\_", "$": r"\$"}- return "".join(escapes.get(char, char) for char in text)-def _make_text_run(text: str) -> ET.Element:"""Build a <w:r><w:t xml:space="preserve">text</w:t></w:r> element."""diff --git a/skills/ppt-master/scripts/source_to_md/ppt_to_md.py b/skills/ppt-master/scripts/source_to_md/ppt_to_md.pyindex a880e567..0d082f03 100644--- a/skills/ppt-master/scripts/source_to_md/ppt_to_md.py+++ b/skills/ppt-master/scripts/source_to_md/ppt_to_md.py@@ -45,6 +45,7 @@ if str(_SCRIPTS_DIR) not in sys.path:from console_encoding import configure_utf8_stdio # noqa: E402from _batch import run_path_batch # noqa: E402from _conversion_profile import write_conversion_profile_best_effort # noqa: E402+from _omml_latex import _local_name, _omml_to_latex # noqa: E402from pptx_ooxml.diagram_read import ( # noqa: E402read_smartart_diagrams,smartart_to_markdown,@@ -74,6 +75,7 @@ DRAWINGML_NS = "http://schemas.openxmlformats.org/drawingml/2006/main"PRESENTATIONML_NS = "http://schemas.openxmlformats.org/presentationml/2006/main"RELATIONSHIP_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships"MARKUP_COMPATIBILITY_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006"+OFFICE_MATH_TAG = "{http://schemas.microsoft.com/office/drawing/2010/main}m"CHARTEX_URI = "http://schemas.microsoft.com/office/drawing/2014/chartex"OFFICE_VECTOR_EXTENSIONS = {"emf", "wmf"}IMAGE_EXT_BY_CONTENT_TYPE = {@@ -301,6 +303,16 @@ def _run_url(run: object, shape: object) -> str | None:return None+def _office_math_markdown(math: object) -> str:+ """Render one a14:m zone as ``$...$``, or ``$$...$$`` for display math."""+ zone = next((item for item in math if _local_name(item) in {"oMathPara", "oMath"}), None)+ latex = _omml_to_latex(zone).strip() if zone is not None else ""+ if not latex:+ return ""+ delimiter = "$$" if _local_name(zone) == "oMathPara" else "$"+ return f"{delimiter}{latex}{delimiter}"++def _paragraph_to_markdown(paragraph: object,shape: object,@@ -338,6 +350,10 @@ def _paragraph_to_markdown(# A soft line break inside the paragraph; python-pptx's runs skip it.current_text += "\n"continue+ if child.tag == OFFICE_MATH_TAG:+ # python-pptx's runs also skip Office Math; keep it as LaTeX.+ current_text += _office_math_markdown(child)+ continueif tag not in {"r", "fld"}:continuerun = _Run(child, paragraph)@@ -515,7 +531,9 @@ def text_frame_to_markdown("""visible_paragraphs = [paragraph for paragraph in text_frame.paragraphs- if normalize_text(paragraph.text) or _paragraph_has_hyperlink(paragraph)+ if normalize_text(paragraph.text)+ or _paragraph_has_hyperlink(paragraph)+ or paragraph._p.find(OFFICE_MATH_TAG) is not None]if not visible_paragraphs:return ""diff --git a/skills/ppt-master/scripts/tests/test_source_to_md_content_loss_pptx.py b/skills/ppt-master/scripts/tests/test_source_to_md_content_loss_pptx.pyindex 5fb2304d..48daebad 100644--- a/skills/ppt-master/scripts/tests/test_source_to_md_content_loss_pptx.py+++ b/skills/ppt-master/scripts/tests/test_source_to_md_content_loss_pptx.py@@ -184,3 +184,32 @@ class PptxContentLossTests(unittest.TestCase):choice.append(sp)md = self._convert(prs)self.assertIn('ratio holds', md)++ def test_office_math_survives_as_latex(self) -> None:+ a14 = 'http://schemas.microsoft.com/office/drawing/2010/main'+ m = 'http://schemas.openxmlformats.org/officeDocument/2006/math'+ mc = 'http://schemas.openxmlformats.org/markup-compatibility/2006'++ def math(display: bool, body: str) -> etree._Element:+ zone = f'<m:oMathPara><m:oMath>{body}</m:oMath></m:oMathPara>' if display \+ else f'<m:oMath>{body}</m:oMath>'+ return etree.fromstring(f'<a14:m xmlns:a14="{a14}" xmlns:m="{m}">{zone}</a14:m>')++ prs, shape = self._presentation()+ inline = shape.text_frame.paragraphs[0]+ inline.text = 'ratio '+ inline._p.append(math(False, '<m:f><m:num><m:r><m:t>a</m:t></m:r></m:num>'+ '<m:den><m:r><m:t>b</m:t></m:r></m:den></m:f>'))+ inline.add_run().text = ' holds'+ display = shape.text_frame.add_paragraph()+ display._p.append(math(True, '<m:sSup><m:e><m:r><m:t>x</m:t></m:r></m:e>'+ '<m:sup><m:r><m:t>2</m:t></m:r></m:sup></m:sSup>'))+ sp = shape._element+ wrapper = etree.Element(f'{{{mc}}}AlternateContent', nsmap={'mc': mc, 'a14': a14})+ choice = etree.SubElement(wrapper, f'{{{mc}}}Choice', Requires='a14')+ etree.SubElement(wrapper, f'{{{mc}}}Fallback')+ sp.getparent().replace(sp, wrapper)+ choice.append(sp)+ md = self._convert(prs)+ self.assertIn(r'ratio $\frac{a}{b}$ holds', md)+ self.assertIn('$$x^2$$', md)