김경종
33 lines
1.9 KiB
Markdown
33 lines
1.9 KiB
Markdown
---
|
|
name: math-markdown-review
|
|
description: 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.
|