English | 中文 | 🌐 Website

A powerful VS Code extension for converting various document formats to Markdown and text formats with just one click.

• Word Documents (.docx, .doc) → Markdown
• Excel Spreadsheets (.xlsx, .xls, .csv) → Markdown Tables
• PDF Documents (.pdf) → Text Files

• ✅ Context Menu Integration - Convert directly from file explorer
• ✅ Command Palette Support - Access via Cmd+Shift+P
• ✅ Batch Conversion - Select folders for bulk processing
• ✅ Smart Text Processing - Automatically optimize conversion quality
• ✅ Progress Indicators - Real-time conversion progress display
• ✅ Error Handling - Comprehensive error messages and handling
• ✅ Multi-language Support - Automatic language switching between English and Chinese

1. Open VS Code Extensions Marketplace (Ctrl+Shift+X or Cmd+Shift+X)
2. Search for "Document Converter" or "hddevteam"
3. Click Install

Visit the VS Code Marketplace and click Install.

# Clone the project
git clone https://github.com/hddevteam/vscode-md-converter.git
cd vscode-md-converter

# Install dependencies
npm install

# Compile extension
npm run compile

# Press F5 in VS Code for debugging

1. Context Menu: Right-click on document files in file explorer and select appropriate conversion option
2. Command Palette:
   • Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux)
   • Type conversion commands (e.g., "Convert Word to Markdown")

1. Right-click on a folder containing documents
2. Select "Batch Convert Documents"
3. Follow prompts to select conversion types and options

• Convert Word to Markdown - Convert Word documents to Markdown
• Convert Excel to Markdown - Convert Excel files to Markdown tables
• Convert PDF to Text - Convert PDF to text files
• Batch Convert Documents - Batch convert documents
• Open Document Converter - Open converter interface
• Test PDF Conversion - Test PDF conversion functionality

• Preserve text formatting (bold, italic, etc.)
• Convert heading levels
• Handle lists and tables
• Support .docx and .doc formats
• Smart timeout handling (prevents .doc file freezing)

• Convert to Markdown table format
• Preserve cell data types
• Handle multiple worksheets
• Support .xlsx, .xls, .csv formats
• Automatic data formatting

• Advanced Text Processing Algorithms:
  • Smart space correction
  • Word boundary detection
  • Punctuation formatting
  • Hyphenated word reconstruction
• Text Quality Optimization:
  • Remove extra whitespace
  • Fix common spacing issues
  • Protect URL and email formats
  • Sentence structure optimization
• Output Enhancement:
  • Add document metadata
  • Organize content by paragraphs
  • Markdown format output

The extension automatically switches interface language based on VS Code language settings:

• English (default) - For English environments
• Chinese - Automatically detects Chinese environments

Supported language features:

• Command titles and descriptions
• User interface text
• Error messages and prompts
• Configuration option descriptions

All converted files are saved in the same directory as the original files with appropriate formats:

• Word → .md files
• Excel → .md files (with tables)
• PDF → .txt files

We're actively working on expanding format support and adding new capabilities:

• 📊 PowerPoint Support: Convert .pptx presentations to Markdown with slide content and speaker notes
• 📋 Table Extraction: Export tables from Word/PDF documents directly to CSV format
• 🖼️ PDF to Images: Convert PDF pages to individual image files (PNG/JPG)
• 📤 Enhanced Export: Export PowerPoint slides and PDF pages as high-quality images
• 🏗️ Architecture Improvements: Better plugin system for future format extensions

View our complete roadmap | Track progress on GitHub

The extension supports the following configuration options (search for "Document Converter" in settings):

• Output directory settings
• Excel maximum rows limit
• Format preservation options
• Auto-open result files

• mammoth.js - Word document processing
• xlsx - Excel file processing
• pdf-parse - PDF text extraction
• VS Code API - Extension integration

src/
├── converters/           # Core converters
│   ├── wordToMarkdown.ts
│   ├── excelToMarkdown.ts
│   └── pdfToText.ts
├── commands/            # VS Code command handlers
├── i18n/               # Internationalization support
│   ├── index.ts        # I18n manager
│   ├── en.ts          # English language pack
│   └── zh-cn.ts       # Chinese language pack
├── utils/              # Utility functions
├── types/              # TypeScript type definitions
└── extension.ts        # Extension entry point

1. Conversion Failed

   • Check if file is corrupted
   • Ensure file is not open in other programs
   • Check VS Code Developer Console for error messages

2. .doc File Conversion Freezing

   • Extension has built-in timeout mechanism
   • Recommend converting .doc files to .docx before processing

3. Poor PDF Text Quality

   • Some PDFs may use image text, recommend using OCR tools
   • Check if PDF is a scanned document

4. Interface Language Issues

   • Extension automatically detects VS Code language settings
   • Supports Chinese (zh-cn) and English environments
   • Can change display language in VS Code settings

Press F5 in VS Code to run extension in debug mode and view detailed log information.

Welcome to submit Issues and Pull Requests to improve this extension!

See our Development Roadmap for planned features and upcoming improvements.

# Clone repository
git clone https://github.com/hddevteam/vscode-md-converter.git
cd vscode-md-converter

# Install dependencies
npm install

# Development mode compilation
npm run watch

# Run tests
npm test

1. Create new language file in src/i18n/ directory
2. Add language detection logic in src/i18n/index.ts
3. Create corresponding package.nls.{language}.json file

MIT License - See LICENSE file for details

• ✨ Added directory structure preservation in batch conversion
• 🗂️ Enhanced subfolder handling with original hierarchy
• 🔄 Improved conversion workflow with better progress reporting
• 🌐 Updated translations for subfolder structure features
• 🧩 Fixed additional context menu integration issues

• ✨ Added enhanced folder batch conversion
• 🔍 Added file count preview before batch conversion
• 🚀 Added conversion confirmation dialog
• ⏱️ Added total duration tracking for batch operations
• 🧩 Fixed folder context menu integration
• 🌐 Updated internationalization for new UI elements

• 🎨 Updated extension branding to "OneClick Markdown Converter"
• 🌐 Enhanced GitHub Pages website with Chinese version
• 🎨 Improved color scheme with modern purple-teal gradients
• 📚 Updated internationalization support
• 🔧 Enhanced documentation and user guides

• 🚀 Published to VS Code Marketplace
• 🌐 Added comprehensive GitHub Pages website
• 📦 Professional packaging and distribution
• 🎨 Created custom extension icon
• 📖 Complete documentation and guides

• ✨ Initial release
• ✅ Word to Markdown conversion
• ✅ Excel to Markdown conversion
• ✅ PDF to text conversion
• ✅ Batch conversion functionality
• ✅ VS Code integration
• ✅ English and Chinese bilingual support

Enjoy the convenience of document conversion! 🎉