Agent skill

Md To PDF Academic

by wentorai in wentorai/research-plugins

Convert Markdown to publication-quality PDF with LaTeX math rendering

MITAuto-check: notesDocuments & Office

Install Md To PDF Academic

skills CLI
$ npx skills add wentorai/research-plugins --skill md-to-pdf-academic -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install wentorai/research-plugins md-to-pdf-academic --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/writing/latex/md-to-pdf-academic .claude/skills/md-to-pdf-academic && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
md-to-pdf-academic
GitHub stars
298
Used in
1 other repo
Token cost
~1.8k tokens
SKILL.md length
410 words
Files
1
Skills in repo
405
Repo updated
First seen
Licence
MIT

At a glance

Convert Markdown to publication-quality PDF with LaTeX math rendering

  • Tasks that involve LaTeX
  • SKILL.md covers Overview, Setup and Prerequisites, Writing Academic Markdown and Building the PDF, plus 2 more sections
  • Calls pandoc, brew and pip; reaches github.com
  • Tasks that involve PDF

What it does

Md To PDF Academic is an agent skill from wentorai/research-plugins. Convert Markdown to publication-quality PDF with LaTeX math rendering

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering LaTeX, PDF and Markdown. It works with LaTeX and Pandoc. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.

When your agent uses it

  • Tasks that involve LaTeX
  • Tasks that involve PDF
  • Tasks that involve Markdown

Example prompts

  • “/md-to-pdf-academic”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit bf44b3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pandoc
    • brew
    • pip
    • apt-get
    • wget

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    Also links to:

    • pandoc.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Md To PDF Academic loads about 1.8k tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 410 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:35
    sudo tlmgr install collection-fontsrecommended latexmk
  • NoteRuns commands with sudoSKILL.md:38
    sudo apt-get install pandoc texlive-full

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 410 words, ~1,815 tokens.

Download SKILL.mdSave it as .claude/skills/md-to-pdf-academic/SKILL.md (or your agent's skills folder).
name
md-to-pdf-academic
description
Convert Markdown to publication-quality PDF with LaTeX math rendering

Markdown to PDF (Academic)

Overview

Many researchers prefer writing in Markdown for its simplicity and readability, but academic publishing demands the typographic quality of LaTeX-rendered PDFs. The Markdown to PDF Academic skill bridges this gap by providing a complete workflow for converting Markdown documents—including mathematical equations, citations, cross-references, figures, and tables—into publication-quality PDFs using Pandoc and LaTeX as the rendering backend.

This approach gives you the best of both worlds: you write in clean, portable Markdown that is easy to version-control and collaborate on, while producing output that is indistinguishable from a paper written directly in LaTeX. The workflow supports all standard academic elements including numbered equations, BibTeX citations, figure floats, and custom LaTeX templates for specific journal or conference formats.

This skill is particularly useful for researchers who find LaTeX syntax cumbersome for drafting but need LaTeX-quality output, for teams where some members are not comfortable with LaTeX, and for documents that need to be published in multiple formats (PDF, HTML, DOCX) from a single source.

Setup and Prerequisites

Required Software

Install the following tools:

bash
# macOS
brew install pandoc
brew install --cask mactex  # Full LaTeX distribution
# or for a minimal install:
brew install basictex
sudo tlmgr install collection-fontsrecommended latexmk

# Ubuntu/Debian
sudo apt-get install pandoc texlive-full

# Verify installation
pandoc --version
pdflatex --version

Install useful Pandoc filters for academic writing:

bash
# Citation processing
pip install pandoc-citeproc  # or use --citeproc flag (built-in since Pandoc 2.11)

# Cross-referencing (figures, tables, equations, sections)
pip install pandoc-crossref

# Include code from external files
pip install pandoc-include
Academic LaTeX Template

Download or create a LaTeX template for your target venue. The Eisvogel template is an excellent general-purpose starting point:

bash
# Download Eisvogel template
mkdir -p ~/.pandoc/templates
wget https://github.com/Wandmalfarbe/pandoc-latex-template/releases/latest/download/Eisvogel.tar.gz
tar -xzf Eisvogel.tar.gz -C ~/.pandoc/templates/

Writing Academic Markdown

Document Header (YAML Front Matter)

Start your Markdown document with YAML metadata:

yaml
---
title: "Your Paper Title"
author:
  - name: "Author One"
    affiliation: "University of Example"
    email: "author@example.edu"
  - name: "Author Two"
    affiliation: "Institute of Research"
date: "March 2026"
abstract: |
  This is the abstract of the paper. It can span
  multiple lines using the YAML block scalar syntax.
keywords: ["keyword one", "keyword two", "keyword three"]
bibliography: references.bib
csl: ieee.csl
numbersections: true
header-includes:
  - \usepackage{amsmath}
  - \usepackage{booktabs}
---
Mathematical Equations

Use standard LaTeX math syntax within Markdown. Pandoc processes these natively:

markdown
Inline math: The loss function $\mathcal{L}(\theta)$ is minimized.

Display math (numbered):
$$
\mathcal{L}(\theta) = -\sum_{i=1}^{N} \log p(y_i | x_i; \theta) {#eq:loss}
$$

Multi-line equations:
$$
\begin{aligned}
\nabla_\theta \mathcal{L} &= \frac{1}{N} \sum_{i=1}^{N} \nabla_\theta \log p(y_i | x_i; \theta) \\
\theta_{t+1} &= \theta_t - \eta \nabla_\theta \mathcal{L}
\end{aligned}
$$

Reference: As shown in @eq:loss (requires pandoc-crossref).
Citations

Reference entries in your BibTeX file using @citekey syntax:

markdown
Recent work has shown promising results [@smith2024; @jones2025].

@smith2024 demonstrated that transformers scale efficiently.

For a comprehensive review, see [-@wang2023].
Show full SKILL.md (164 more words)Show less
Figures and Tables
markdown
![Architecture of our proposed model. The encoder processes
input sequences while the decoder generates output tokens
autoregressively.](figures/architecture.pdf){#fig:arch width=80%}

As shown in Figure @fig:arch, the architecture consists of...

| Method | Accuracy | F1 Score | Params (M) |
|--------|----------|----------|------------|
| Baseline | 82.3 | 79.1 | 110 |
| **Ours** | **87.6** | **84.9** | 95 |

: Comparison of methods on the benchmark dataset. {#tbl:results}

Results in Table @tbl:results show that...

Building the PDF

Basic Conversion Command
bash
pandoc paper.md \
  -o paper.pdf \
  --pdf-engine=pdflatex \
  --citeproc \
  --filter pandoc-crossref \
  --number-sections \
  --bibliography=references.bib \
  --csl=ieee.csl \
  --template=eisvogel
Makefile for Reproducible Builds

Create a Makefile for consistent builds:

makefile
PAPER = paper
PANDOC_FLAGS = --pdf-engine=pdflatex \
               --citeproc \
               --filter pandoc-crossref \
               --number-sections \
               --bibliography=references.bib

pdf: $(PAPER).md
	pandoc $(PAPER).md -o $(PAPER).pdf $(PANDOC_FLAGS) --template=eisvogel

docx: $(PAPER).md
	pandoc $(PAPER).md -o $(PAPER).docx $(PANDOC_FLAGS)

html: $(PAPER).md
	pandoc $(PAPER).md -o $(PAPER).html $(PANDOC_FLAGS) --standalone --mathjax

clean:
	rm -f $(PAPER).pdf $(PAPER).docx $(PAPER).html

.PHONY: pdf docx html clean
Custom LaTeX Templates

For specific journal formats, create a custom Pandoc template. Start from the default and modify:

bash
# Export default template
pandoc -D latex > my-template.tex

# Edit my-template.tex to match your journal's requirements
# Then use it:
pandoc paper.md -o paper.pdf --template=my-template.tex

Key template variables you can set from YAML front matter:

  • documentclass: article, report, book, or a journal's custom class
  • fontsize: 10pt, 11pt, 12pt
  • geometry: margins (e.g., margin=1in)
  • linestretch: line spacing (1.0 = single, 1.5 = one-and-a-half, 2.0 = double)

Troubleshooting Common Issues

  • Missing LaTeX packages: Install with tlmgr install <package-name>
  • Unicode characters in text: Use --pdf-engine=xelatex or lualatex instead of pdflatex
  • Figure not found: Use relative paths from the Markdown file's directory; ensure the file extension matches
  • Citation not resolving: Verify the cite key matches exactly (case-sensitive) between your Markdown and .bib file
  • Equation numbering: Requires pandoc-crossref; use {#eq:label} syntax after display equations
  • Table overflow: Add \usepackage{adjustbox} in header-includes and use \adjustbox{max width=\textwidth} in the template

References

© wentorai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/writing/latex/md-to-pdf-academic of wentorai/research-plugins.

Open the folder on GitHubat commit bf44b3c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Md To PDF Academic next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Md To PDF Academic compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Md To PDF Academic this skillwentorai/research-plugins2981 repos~1.8kAutomated safety check: NotesMIT
Md To PDFMathews-Tom/armory329—~2.4kAutomated safety check: PassMIT
Markerbenchflow-ai/skillsbench1.8k—~520Automated safety check: PassApache-2.0
MineruNebutra/MinerU-Skill123—~504Automated safety check: PassMIT
Lecture To Mdysyecust/lecture-to-notes273—~3.9kAutomated safety check: PassCustom licence
Pandic OfficeTeam-Commonly/commonly1.4k—~642Automated safety check: PassApache-2.0

Similar skills

  • Md To PDF

    Mathews-Tom/armory

    Convert Markdown to styled PDFs with Mermaid diagrams, LaTeX/KaTeX math, tables, and code highlighting.

    329 GitHub stars~2.4k tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed
  • Marker

    benchflow-ai/skillsbench

    Convert PDF documents to Markdown using markersingle. An agent skill from benchflow-ai/skillsbench.

    1.8k GitHub stars~520 tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~504 tokensUpdated 17 days ago
    Documents & OfficeAuto-check passed
  • Lecture To Md

    ysyecust/lecture-to-notes

    把课堂视频(本地或 B 站/YouTube)、文字稿、课件三者(任意组合)整理成一份详细的中文 Markdown 课堂笔记,输出按课程标题命名的 {titlename}.md(首行为 文档标题)+ 相对路径图片。Markdown 工作流,与上游 lecture-to-notes 的 LaTeX/PDF 输出并行存在;上游 skill 完全不动。触发词:markdown 笔记、md 笔记、视频转…

    273 GitHub stars~3.9k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed
  • Pandic Office

    Team-Commonly/commonly

    Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI.

    1.4k GitHub stars~642 tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • 中国软件著作权申请材料生成工具。申请表直接输出 Markdown 提交,源程序/用户手册/设计说明书三份生成 LaTeX 并编译为 PDF。自动分析项目代码,生成四份材料(前后各30页共60页源程序、含页眉页脚的用户手册和设计说明书、Markdown…

    183 GitHub stars~2.8k tokensUpdated 4 days ago
    Documents & OfficeAuto-check: notes

More from wentorai/research-plugins

All 405 skills in this repo
  • Abstract Writing Guide

    wentorai/research-plugins

    Craft structured research abstracts that maximize clarity and journal acceptance

    298 GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Academic Citation Manager

    wentorai/research-plugins

    Manage academic citations across BibTeX, APA, MLA, and Chicago formats

    298 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Academic Paper Summarizer

    wentorai/research-plugins

    Summarize academic papers with structured extraction of key elements

    298 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Academic Study Methods

    wentorai/research-plugins

    Evidence-based study techniques for academic learning and retention

    298 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Academic Tone Guide

    wentorai/research-plugins

    Adjust writing tone and register for academic audiences and venues

    298 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Academic Translation Guide

    wentorai/research-plugins

    Academic translation, post-editing, and Chinglish correction guide

    298 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Works with

Questions about Md To PDF Academic

What does Md To PDF Academic do?

Convert Markdown to publication-quality PDF with LaTeX math rendering. Md To PDF Academic is an agent skill from wentorai/research-plugins.

When should I use Md To PDF Academic?

Md To PDF Academic fits situations like: tasks that involve LaTeX; tasks that involve PDF; tasks that involve Markdown.

How do I install Md To PDF Academic in Claude Code?

Run `npx skills add wentorai/research-plugins --skill md-to-pdf-academic -a claude-code`. Or copy the skill folder (skills/writing/latex/md-to-pdf-academic in wentorai/research-plugins) into .claude/skills/md-to-pdf-academic in your project. Claude Code loads it when a task matches its description.

How do I install Md To PDF Academic in Codex?

Run `npx skills add wentorai/research-plugins --skill md-to-pdf-academic -a codex`. Or copy the skill folder (skills/writing/latex/md-to-pdf-academic in wentorai/research-plugins) into .agents/skills/md-to-pdf-academic in your project. Codex loads it when a task matches its description.

Can I use Md To PDF Academic in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill md-to-pdf-academic -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/md-to-pdf-academic, .gemini/skills/md-to-pdf-academic, .github/skills/md-to-pdf-academic and .opencode/skills/md-to-pdf-academic in your project.

What does Md To PDF Academic need to run?

Going by SKILL.md and its folder, Md To PDF Academic needs the command-line tools its instructions call (pandoc, brew, pip, apt-get and wget). Our summary lists: Python 3.

Does Md To PDF Academic access the network?

SKILL.md names 2 domains. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. As links in the text: pandoc.org. This is read from the text; nothing was executed.

Is Md To PDF Academic safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Md To PDF Academic use?

Md To PDF Academic is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Md To PDF Academic use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Md To PDF Academic?

Skills that share tags, products or a category with Md To PDF Academic: Md To PDF (Mathews-Tom/armory, 329 stars), Marker (benchflow-ai/skillsbench, 1.8k stars), Mineru (Nebutra/MinerU-Skill, 123 stars) and Lecture To Md (ysyecust/lecture-to-notes, 273 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Md To PDF Academic?

wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.

Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.