mcpField
D
docs-latex

docs-latex

github.com/laurigatesDocuments5989 installsUpdated 1d ago
Repository

About docs-latex

A skill for converting Markdown into professionally typeset LaTeX documents and PDFs. It is suited to report authors who need structured documents, optional TikZ/PGFPlots visualizations, and PDF compilation.

Key features

  1. 01Convert Markdown structure to LaTeX
  2. 02Support tables, lists, and code blocks
  3. 03Generate TikZ/PGFPlots visualizations
  4. 04Use report structure presets
  5. 05Compile LaTeX into PDF

Use cases

  1. 01Prepare a print-ready project report
  2. 02Create a roadmap with timeline visuals
  3. 03Turn lifecycle data into charts
  4. 04Generate a PDF from Markdown

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/laurigates/claude-plugins --skill docs-latex

After installing, type/docs-latexin Claude Code to confirm it loaded.

Bundled filesREFERENCE.md

Details

From the project README

Markdown to LaTeX Conversion

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

When to Use This Skill

Use this skill when...Use another skill when...
Converting Markdown to presentation-quality PDFWriting Markdown documentation (/docs:generate)
Creating reports with diagrams and visualizationsSimple text formatting
Generating print-ready strategic documentsCreating HTML documentation
Building lifecycle reports with charts and timelinesSyncing existing docs (/docs:sync)

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:

MarkdownLaTeX
# Title\chapter{Title}
## Section\section{Section}
### Subsection\subsection{Subsection}
**bold**\textbf{bold}
*italic*\textit{italic}
`code`\texttt{code}
- item\begin{itemize}\item ...\end{itemize}
1. item\begin{enumerate}\item ...\end{enumerate}
> quote\begin{tcolorbox}...\end{tcolorbox}
[text](url)\href{url}{text}
Tablesbooktabs tables with \toprule, \midrule, \bottomrule
Code blocks\begin{lstlisting}...\end{lstlisting}
- [ ] / - [x]$\square$ / $\boxtimes$ (requires amssymb)
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
  2. Compile with two passes for cross-references: 
    pdflatex -interaction=nonstopmode DOCUMENT.tex
pdflatex -interaction=nonstopmode DOCUMENT.tex
  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

ContextCommand
Check LaTeX installedwhich pdflatex 2>/dev/null
Quick compilepdflatex -interaction=nonstopmode -halt-on-error FILE.tex
Full compile (with TOC)pdflatex -interaction=nonstopmode FILE.tex && pdflatex -interaction=nonstopmode FILE.tex
Check PDF page countpdfinfo FILE.pdf 2>/dev/null
Check PDF file sizestat -f %z FILE.pdf 2>/dev/null
Install toolchainapt-get install -y texlive-latex-extra texlive-fonts-recommended texlive-fonts-extra texlive-science
Errors onlypdflatex -interaction=nonstopmode FILE.tex 2>&1

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

Comments

Markdown supported