Office To Md

Documents

office-to-md

Office To Md is an Agent Skill for documents published in the shuyu-labs/WebCode repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Convert Office documents (Word, Excel, PowerPoint, PDF) to Markdown format. ONLY use this skill when the user explicitly requests to CONVERT, TRANSFORM or PARSE a specific office file into Markdown. Do NOT trigger for general questions, documentation reading, or discussions about files.

View on GitHub ↗

QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

Open your project in Codex.
Copy and paste the prompt below.
Review files and risks before approving any action.

Prompt to paste

Inspect the Agent Skill at https://github.com/shuyu-labs/WebCode/blob/HEAD/skills/claude/office-to-md/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/office-to-md, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Office Document to Markdown Converter

Convert various Office document formats to structured Markdown with text, table, and image extraction.

File Description

enhanced_parser.py - Core document parser
doc_converter.py - DOC to DOCX converter (requires LibreOffice)
requirements.txt - Python dependencies

Install Dependencies

pip install -r requirements.txt

Additional Dependencies for DOC Format

.doc format requires LibreOffice:

# Windows: Install LibreOffice from official website
# https://www.libreoffice.org/download/

# Linux
sudo apt install libreoffice

# Mac
brew install --cask libreoffice

Quick Start

Python Code

from enhanced_parser import EnhancedDocumentParser

# Initialize parser
parser = EnhancedDocumentParser(
    image_base_url="http://localhost:5000",
    image_save_dir="./static/images",
    filter_headers_footers=True  # Filter headers and footers
)

# Parse document
result = parser.parse_document("document.docx")

if result["success"]:
    print(result["markdown"])
    print(f"Extracted {result['images_count']} images")

Start API Service

# Start service using app.py from project root
python app.py

# Visit http://localhost:5000/analyzer to upload files

Supported Formats

Format	Extensions	Notes
Word	.docx, .doc	.doc requires LibreOffice
Excel	.xlsx, .xls	Supports multiple worksheets and date formats
PowerPoint	.pptx	Extracts slide text and images
PDF	.pdf	Auto-detects tables and images

Features

Word Documents

Automatic heading level detection
Convert tables to Markdown tables
Extract inline images
Filter headers and footers
Preserve list formatting

Excel Workbooks

Support for multiple worksheets
Automatic date format detection (prevents display as numbers)
Convert to Markdown tables
Extract embedded images

PowerPoint Presentations

Extract content by slide
Extract images and text boxes
Preserve slide order

PDF Documents

Auto-detect tables (line detection + text position detection)
Extract page images
Intelligently identify headings and lists
Output content in original order

Advanced Options

DOC Conversion

# Test LibreOffice configuration
python doc_converter.py

PDF Table Strategy

parser = EnhancedDocumentParser(
    pdf_table_strategy="lines_strict"  # Default: strict line detection, fastest
    # "lines": Normal line detection
    # "text": Based on text position, more accurate but slower
)

Image Processing

parser = EnhancedDocumentParser(
    image_base_url="https://your-domain.com",  # Image access URL
    image_save_dir="./static/images"           # Image save directory
)

Return Format

{
  "success": true,
  "markdown": "# Document Title\n\nContent...",
  "images_count": 2,
  "images": [
    {
      "filename": "uuid.png",
      "url": "http://localhost:5000/static/images/uuid.png",
      "size": 12345
    }
  ],
  "file_type": "docx",
  "file_info": {
    "name": "document.docx",
    "size": 45678,
    "paragraphs": 50,
    "tables": 3
  }
}

Common Issues

DOC Conversion Failed

Ensure LibreOffice is installed
Run python doc_converter.py to test configuration

Dates Display as Numbers

Excel parsing automatically handles date formats
Ensure you're using the latest version of enhanced_parser.py

PDF Table Recognition Inaccurate

Try different pdf_table_strategy parameters
Use "lines_strict" for standard tables
Use "text" for complex tables

File Limitations

Maximum file size: 160MB
Supported extensions: docx, doc, pdf, xlsx, xls, pptx
Automatic cleanup of temporary files