Md To Office

by claude-office-skills9c4c7d5cd281MIT499 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 8 months ago

Instructions onlyDocuments & Office

AI-generated overview

Converts Markdown files into Word, PowerPoint, PDF and other office formats using Pandoc.

What it does: The skill provides instructions and command examples for converting Markdown into office formats such as .docx, .pptx, .pdf, .html, .tex and .epub using Pandoc. It covers reference templates, tables of contents, YAML metadata, slide structure, and Python or pypandoc wrappers. It also includes batch conversion and report generation patterns.
When to use it: Use it when you have Markdown content and need a Word document, slide deck, PDF or similar office file. It suits turning README files, notes or structured reports into styled deliverables, optionally with a corporate template.
Requirements: Requires Pandoc installed; PDF output additionally needs LaTeX or wkhtmltopdf. Python examples use subprocess and optionally pypandoc. No scripts ship with the skill; it is instructions only.

Markdown to Office Skill

Overview

This skill enables conversion from Markdown to various Office formats using Pandoc - the universal document converter. Convert your Markdown files to professional Word documents, PowerPoint presentations, PDFs, and more while preserving formatting and structure.

How to Use

Provide the Markdown content or file
Specify the target format (docx, pptx, pdf, etc.)
Optionally provide a reference template for styling
I'll convert using Pandoc with optimal settings

Example prompts:

"Convert this README.md to a professional Word document"
"Turn my markdown notes into a PowerPoint presentation"
"Generate a PDF from this markdown with custom styling"
"Create a Word doc from this markdown using company template"

Domain Knowledge

Pandoc Fundamentals

bash

# Basic conversionpandoc input.md -o output.docxpandoc input.md -o output.pdfpandoc input.md -o output.pptx
# With templatepandoc input.md --reference-doc=template.docx -o output.docx
# Multiple inputspandoc ch1.md ch2.md ch3.md -o book.docx

# Basic conversionpandoc input.md -o output.docxpandoc input.md -o output.pdfpandoc input.md -o output.pptx
# With templatepandoc input.md --reference-doc=template.docx -o output.docx
# Multiple inputspandoc ch1.md ch2.md ch3.md -o book.docx

Supported Conversions

From	To	Command
Markdown	Word	`pandoc in.md -o out.docx`
Markdown	PDF	`pandoc in.md -o out.pdf`
Markdown	PowerPoint	`pandoc in.md -o out.pptx`
Markdown	HTML	`pandoc in.md -o out.html`
Markdown	LaTeX	`pandoc in.md -o out.tex`
Markdown	EPUB	`pandoc in.md -o out.epub`

Markdown to Word (.docx)

Basic Conversion

With Template (Reference Doc)

bash

# First create a template by converting samplepandoc sample.md -o reference.docx
# Edit reference.docx styles in Word, then use itpandoc input.md --reference-doc=reference.docx -o output.docx

# First create a template by converting samplepandoc sample.md -o reference.docx
# Edit reference.docx styles in Word, then use itpandoc input.md --reference-doc=reference.docx -o output.docx

With Table of Contents

With Metadata

bash

pandoc document.md \  --metadata title="My Report" \  --metadata author="John Doe" \  --metadata date="2024-01-15" \  -o document.docx

pandoc document.md \  --metadata title="My Report" \  --metadata author="John Doe" \  --metadata date="2024-01-15" \  -o document.docx

Markdown to PDF

Via LaTeX (Best Quality)

bash

# Requires LaTeX installationpandoc document.md -o document.pdf
# With custom settingspandoc document.md \  --pdf-engine=xelatex \  -V geometry:margin=1in \  -V fontsize=12pt \  -o document.pdf

# Requires LaTeX installationpandoc document.md -o document.pdf
# With custom settingspandoc document.md \  --pdf-engine=xelatex \  -V geometry:margin=1in \  -V fontsize=12pt \  -o document.pdf

Via HTML/wkhtmltopdf

PDF Options

bash

pandoc document.md \  -V papersize:a4 \  -V geometry:margin=2cm \  -V fontfamily:libertinus \  -V colorlinks:true \  --toc \  -o document.pdf

pandoc document.md \  -V papersize:a4 \  -V geometry:margin=2cm \  -V fontfamily:libertinus \  -V colorlinks:true \  --toc \  -o document.pdf

Markdown to PowerPoint (.pptx)

Basic Conversion

Markdown Structure for Slides

markdown

---title: Presentation Titleauthor: Author Namedate: January 2024---
# Section Header (creates section divider)
## Slide Title
- Bullet point 1- Bullet point 2  - Sub-bullet
## Another Slide
Content here
::: notesSpeaker notes go here (not visible in slides):::
## Slide with Image
![Description](image.png){width=80%}
## Two Column Slide
:::::::::::::: {.columns}::: {.column width="50%"}Left column content:::
::: {.column width="50%"}Right column content:::::::::::::::::

---title: Presentation Titleauthor: Author Namedate: January 2024---
# Section Header (creates section divider)
## Slide Title
- Bullet point 1- Bullet point 2  - Sub-bullet
## Another Slide
Content here
::: notesSpeaker notes go here (not visible in slides):::
## Slide with Image
![Description](image.png){width=80%}
## Two Column Slide
:::::::::::::: {.columns}::: {.column width="50%"}Left column content:::
::: {.column width="50%"}Right column content:::::::::::::::::

With Template

bash

# Use corporate PowerPoint templatepandoc slides.md --reference-doc=template.pptx -o presentation.pptx

# Use corporate PowerPoint templatepandoc slides.md --reference-doc=template.pptx -o presentation.pptx

YAML Frontmatter

Add metadata at the top of your Markdown:

yaml

---title: "Document Title"author: "Author Name"date: "2024-01-15"abstract: "Brief description"toc: truetoc-depth: 2numbersections: truegeometry: margin=1infontsize: 11ptdocumentclass: report---
# First Chapter...

---title: "Document Title"author: "Author Name"date: "2024-01-15"abstract: "Brief description"toc: truetoc-depth: 2numbersections: truegeometry: margin=1infontsize: 11ptdocumentclass: report---
# First Chapter...

Python Integration

python

import subprocessimport os
def md_to_docx(input_path, output_path, template=None):    """Convert Markdown to Word document."""    cmd = ['pandoc', input_path, '-o', output_path]        if template:        cmd.extend(['--reference-doc', template])        subprocess.run(cmd, check=True)    return output_path
def md_to_pdf(input_path, output_path, **options):    """Convert Markdown to PDF with options."""    cmd = ['pandoc', input_path, '-o', output_path]        if options.get('toc'):        cmd.append('--toc')        if options.get('margin'):        cmd.extend(['-V', f"geometry:margin={options['margin']}"])        subprocess.run(cmd, check=True)    return output_path
def md_to_pptx(input_path, output_path, template=None):    """Convert Markdown to PowerPoint."""    cmd = ['pandoc', input_path, '-o', output_path]        if template:        cmd.extend(['--reference-doc', template])        subprocess.run(cmd, check=True)    return output_path

import subprocessimport os
def md_to_docx(input_path, output_path, template=None):    """Convert Markdown to Word document."""    cmd = ['pandoc', input_path, '-o', output_path]        if template:        cmd.extend(['--reference-doc', template])        subprocess.run(cmd, check=True)    return output_path
def md_to_pdf(input_path, output_path, **options):    """Convert Markdown to PDF with options."""    cmd = ['pandoc', input_path, '-o', output_path]        if options.get('toc'):        cmd.append('--toc')        if options.get('margin'):        cmd.extend(['-V', f"geometry:margin={options['margin']}"])        subprocess.run(cmd, check=True)    return output_path
def md_to_pptx(input_path, output_path, template=None):    """Convert Markdown to PowerPoint."""    cmd = ['pandoc', input_path, '-o', output_path]        if template:        cmd.extend(['--reference-doc', template])        subprocess.run(cmd, check=True)    return output_path

pypandoc (Python Wrapper)

python

import pypandoc
# Simple conversionoutput = pypandoc.convert_file('input.md', 'docx', outputfile='output.docx')
# With optionsoutput = pypandoc.convert_file(    'input.md',     'docx',    outputfile='output.docx',    extra_args=['--toc', '--reference-doc=template.docx'])
# From stringmd_content = "# Hello\n\nThis is markdown."output = pypandoc.convert_text(md_content, 'docx', format='md', outputfile='output.docx')

import pypandoc
# Simple conversionoutput = pypandoc.convert_file('input.md', 'docx', outputfile='output.docx')
# With optionsoutput = pypandoc.convert_file(    'input.md',     'docx',    outputfile='output.docx',    extra_args=['--toc', '--reference-doc=template.docx'])
# From stringmd_content = "# Hello\n\nThis is markdown."output = pypandoc.convert_text(md_content, 'docx', format='md', outputfile='output.docx')

Best Practices

Use Templates: Create a reference document for consistent branding
Structure Headers: Use consistent heading levels (## for slides, # for sections)
Test Incrementally: Convert small sections first to verify formatting
Include Metadata: Use YAML frontmatter for document properties
Handle Images: Use relative paths and specify dimensions

Common Patterns

Batch Conversion

python

import subprocessfrom pathlib import Path
def batch_convert(input_dir, output_format, output_dir=None):    """Convert all markdown files in a directory."""    input_path = Path(input_dir)    output_path = Path(output_dir) if output_dir else input_path        for md_file in input_path.glob('*.md'):        output_file = output_path / md_file.with_suffix(f'.{output_format}').name        subprocess.run([            'pandoc', str(md_file), '-o', str(output_file)        ], check=True)        print(f"Converted: {md_file.name} -> {output_file.name}")
batch_convert('./docs', 'docx', './output')

import subprocessfrom pathlib import Path
def batch_convert(input_dir, output_format, output_dir=None):    """Convert all markdown files in a directory."""    input_path = Path(input_dir)    output_path = Path(output_dir) if output_dir else input_path        for md_file in input_path.glob('*.md'):        output_file = output_path / md_file.with_suffix(f'.{output_format}').name        subprocess.run([            'pandoc', str(md_file), '-o', str(output_file)        ], check=True)        print(f"Converted: {md_file.name} -> {output_file.name}")
batch_convert('./docs', 'docx', './output')

Report Generator

python

def generate_report(title, sections, output_path, template=None):    """Generate Word report from structured data."""        # Build markdown    md_content = f"""---title: "{title}"date: "{datetime.now().strftime('%B %d, %Y')}"---
"""    for section_title, content in sections.items():        md_content += f"# {section_title}\n\n{content}\n\n"        # Write temp file    with open('temp_report.md', 'w') as f:        f.write(md_content)        # Convert    cmd = ['pandoc', 'temp_report.md', '-o', output_path, '--toc']    if template:        cmd.extend(['--reference-doc', template])        subprocess.run(cmd, check=True)    os.remove('temp_report.md')

def generate_report(title, sections, output_path, template=None):    """Generate Word report from structured data."""        # Build markdown    md_content = f"""---title: "{title}"date: "{datetime.now().strftime('%B %d, %Y')}"---
"""    for section_title, content in sections.items():        md_content += f"# {section_title}\n\n{content}\n\n"        # Write temp file    with open('temp_report.md', 'w') as f:        f.write(md_content)        # Convert    cmd = ['pandoc', 'temp_report.md', '-o', output_path, '--toc']    if template:        cmd.extend(['--reference-doc', template])        subprocess.run(cmd, check=True)    os.remove('temp_report.md')

Examples

Example 1: Technical Documentation

python

import subprocess
# Create comprehensive markdowndoc = """---title: "API Documentation"author: "Dev Team"date: "2024-01-15"toc: truetoc-depth: 2---
# Introduction
This document describes the REST API for our service.
## Authentication
All API requests require an API key in the header:

import subprocess
# Create comprehensive markdowndoc = """---title: "API Documentation"author: "Dev Team"date: "2024-01-15"toc: truetoc-depth: 2---
# Introduction
This document describes the REST API for our service.
## Authentication
All API requests require an API key in the header:

Authorization: Bearer YOUR_API_KEY


## Endpoints
### GET /users
Retrieve all users.
**Response:**
| Field | Type | Description ||-------|------|-------------|| id | integer | User ID || name | string | Full name || email | string | Email address |
### POST /users
Create a new user.
**Request Body:**
```json{  "name": "John Doe",  "email": "[email protected]"}


## Endpoints
### GET /users
Retrieve all users.
**Response:**
| Field | Type | Description ||-------|------|-------------|| id | integer | User ID || name | string | Full name || email | string | Email address |
### POST /users
Create a new user.
**Request Body:**
```json{  "name": "John Doe",  "email": "[email protected]"}

Error Codes

Save markdown

with open('api_docs.md', 'w') as f: f.write(doc)

Convert to Word

subprocess.run([ 'pandoc', 'api_docs.md', '-o', 'api_documentation.docx', '--toc', '--reference-doc', 'company_template.docx' ], check=True)

Convert to PDF

subprocess.run([ 'pandoc', 'api_docs.md', '-o', 'api_documentation.pdf', '--toc', '-V', 'geometry:margin=1in', '-V', 'fontsize=11pt' ], check=True)


### Example 2: Presentation from Markdown```pythonslides_md = """---title: "Q4 Business Review"author: "Sales Team"date: "January 2024"---
# Overview
## Agenda
- Q4 Performance Summary- Regional Highlights- 2024 Outlook- Q&A
# Q4 Performance
## Key Metrics
- Revenue: $12.5M (+15% YoY)- New Customers: 250- Retention Rate: 94%
## Regional Performance
:::::::::::::: {.columns}::: {.column width="50%"}**North America**
- Revenue: $6.2M- Growth: +18%:::
::: {.column width="50%"}**Europe**
- Revenue: $4.1M- Growth: +12%:::::::::::::::::
# 2024 Outlook
## Strategic Priorities
1. Expand APAC presence2. Launch new product line3. Improve customer onboarding
## Revenue Targets
| Quarter | Target ||---------|--------|| Q1 | $13M || Q2 | $14M || Q3 | $15M || Q4 | $16M |
# Thank You
## Questions?
Contact: [email protected]"""
with open('presentation.md', 'w') as f:    f.write(slides_md)
subprocess.run([    'pandoc', 'presentation.md',    '-o', 'q4_review.pptx',    '--reference-doc', 'company_slides.pptx'], check=True)


### Example 2: Presentation from Markdown```pythonslides_md = """---title: "Q4 Business Review"author: "Sales Team"date: "January 2024"---
# Overview
## Agenda
- Q4 Performance Summary- Regional Highlights- 2024 Outlook- Q&A
# Q4 Performance
## Key Metrics
- Revenue: $12.5M (+15% YoY)- New Customers: 250- Retention Rate: 94%
## Regional Performance
:::::::::::::: {.columns}::: {.column width="50%"}**North America**
- Revenue: $6.2M- Growth: +18%:::
::: {.column width="50%"}**Europe**
- Revenue: $4.1M- Growth: +12%:::::::::::::::::
# 2024 Outlook
## Strategic Priorities
1. Expand APAC presence2. Launch new product line3. Improve customer onboarding
## Revenue Targets
| Quarter | Target ||---------|--------|| Q1 | $13M || Q2 | $14M || Q3 | $15M || Q4 | $16M |
# Thank You
## Questions?
Contact: [email protected]"""
with open('presentation.md', 'w') as f:    f.write(slides_md)
subprocess.run([    'pandoc', 'presentation.md',    '-o', 'q4_review.pptx',    '--reference-doc', 'company_slides.pptx'], check=True)

Limitations

Complex Word formatting may not convert perfectly
PDF conversion requires LaTeX or wkhtmltopdf
PowerPoint animations not supported
Some advanced tables may need manual adjustment
Image positioning can be tricky

Installation

bash

# macOSbrew install pandoc
# Ubuntu/Debiansudo apt-get install pandoc
# Windowschoco install pandoc
# Python wrapperpip install pypandoc

# macOSbrew install pandoc
# Ubuntu/Debiansudo apt-get install pandoc
# Windowschoco install pandoc
# Python wrapperpip install pypandoc

Resources

Source and attribution

Source:claude-office-skills/skillsinmd-to-officeat commit9c4c7d5

License: MIT

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Code	Meaning
400	Bad Request
401	Unauthorized
404	Not Found
500	Server Error
"""

Md To Office

Markdown to Office Skill

Overview

How to Use

Domain Knowledge

Pandoc Fundamentals

Supported Conversions

Markdown to Word (.docx)

Basic Conversion

With Template (Reference Doc)

With Table of Contents

With Metadata

Markdown to PDF

Via LaTeX (Best Quality)

Via HTML/wkhtmltopdf

PDF Options

Markdown to PowerPoint (.pptx)

Basic Conversion

Markdown Structure for Slides

With Template

YAML Frontmatter

Python Integration

pypandoc (Python Wrapper)

Best Practices

Common Patterns

Batch Conversion

Report Generator

Examples

Example 1: Technical Documentation

Error Codes

Save markdown

Convert to Word

Convert to PDF

Limitations

Installation

Resources

Source and attribution

More from claude-office-skills/skills

Whatsapp Automation

Xlsx Manipulation

Web Search

Weekly Report

Tiktok Marketing

Template Engine

More in Documents & Office

Pdf

View Pdf

Wiki Ado Convert

Esign Field Placement

Visa Doc Translate

Google Workspace Ops