PDFToMD/.codex/skills/math-markdown-review/SKILL.md

name, description

name	description
math-markdown-review	Review and design Obsidian-friendly Markdown normalization for math-heavy PDF conversion, including LaTeX delimiters, display math spacing, asset links, tables, and quality report warnings. Use when Codex needs to check Markdown output assumptions, design post-processing rules, or define renderability checks for formulas and assets.

Math Markdown Review

Overview

Use this skill when Markdown output quality matters more than raw text extraction. The goal is best-effort automatic conversion with explicit warnings and provenance for failures.

Workflow

1. Read PLAN.md and PROGRESS.md first.
2. Read docs/WORKARCHIVE.md when prior Markdown output, MathJax, or sample conversion evidence is needed.
3. Read PRD.md and ARCHITECTURE.md when output behavior, internal provenance, or reporting is affected.
4. Preserve project delimiter policy: inline math uses $...$; display math uses $$...$$.
5. Check asset links, table fallback behavior, heading/list interactions, and page boundary markers against Obsidian rendering assumptions.
6. Define warnings for low-confidence math, non-renderable LaTeX, broken asset links, table degradation, and reading-order uncertainty.
7. Ensure _report.md content is derived from internal provenance, not separate manual state.

Checks

• Inline math should not contain unescaped newlines or surrounding spaces that break rendering.
• Display math should be separated from surrounding paragraphs by blank lines.
• Asset paths should be stable, relative to the Markdown file, and safe for Obsidian vaults.
• Tables with formulas should prefer readable Markdown when reliable and warn when downgraded.
• Every renderability failure should be countable in internal provenance and visible in _report.md.

Reference

Read references/obsidian-output-checks.md for concrete normalization and report-signal guidance.