Markdown to LaTeX Conversion

Convert Markdown documents to professional LaTeX with advanced typesetting, TikZ/PGFPlots visualizations, and PDF compilation.

When to Use This Skill

Context

• Current directory: !pwd
• Available .md files: !find . -maxdepth 2 -name '*.md' -not -name 'CHANGELOG.md' -not -name 'README.md'

Parameters

• <file>: Path to the Markdown source file (required)
• --no-compile: Generate .tex file only, skip PDF compilation
• --visualizations: Include TikZ/PGFPlots diagrams (timelines, charts, risk matrices)
• --report-type: Document structure preset
  • roadmap: Phase-based roadmap with timeline visualization
  • lifecycle: Project lifecycle with release charts and velocity graphs
  • general: Standard professional document (default)

Execution

Execute this Markdown-to-LaTeX conversion workflow:

Step 1: Analyze the Markdown source

Read the source Markdown file and extract:

• Document title and metadata
• Section hierarchy (map # levels to LaTeX chapters/sections)
• Tables, lists, code blocks, callout blocks, and blockquotes
• Priorities or status indicators for color-coded markers
• Numerical data suitable for visualization

Step 2: Generate the LaTeX document

Create a .tex file adjacent to the source. Use the document preamble, color definitions, custom environments, and conversion rules from REFERENCE.md.

Apply the Markdown-to-LaTeX conversion rules:

Step 3: Add visualizations (when --visualizations or data suggests it)

Choose appropriate TikZ/PGFPlots visualizations based on document content. Use the visualization templates from REFERENCE.md:

• Timeline for roadmaps with phases
• Bar/pie charts for release or metric data
• Risk matrix for documents with risk/impact data
• Test pyramid for QA/testing documents

Step 4: Compile to PDF

1. Install LaTeX toolchain if not available:

   apt-get update && apt-get install -y texlive-latex-extra texlive-fonts-recommended \
     texlive-fonts-extra texlive-science latexmk
   

   Copy
2. Compile with two passes for cross-references:

   pdflatex -interaction=nonstopmode DOCUMENT.tex
   pdflatex -interaction=nonstopmode DOCUMENT.tex
   

   Copy
3. If compilation fails, check REFERENCE.md for common compilation fixes.

Step 5: Clean up repository artifacts

Add LaTeX build artifacts to .gitignore if not already present: *.aux, *.log, *.out, *.toc, *.lof, *.lot, *.fls, *.fdb_latexmk, *.synctex.gz, *.bbl, *.blg, *.nav, *.snm, *.vrb.

Post-actions

1. Report the output PDF path, page count, and file size
2. Summarize what visualizations were generated
3. List any compilation warnings that may need attention
4. Suggest the .gitignore additions if not already present

Agentic Optimizations

For detailed LaTeX patterns, TikZ templates, and package reference, see REFERENCE.md.