eml2md

A fast, lightweight command-line tool to convert EML (email) files to Markdown format.

Features

• EML Parsing: Parse standard EML files including headers (From, To, CC, Date, Subject) and body content
• Multiple Formats: Support for simple (plain text) and html output formats
• Attachment Handling: Embed inline images as base64 data URIs in the output
• Clean Output: Email metadata formatted as Markdown tables for easy reading

Installation

From Source

Requires Rust (2024 edition).

git clone https://github.com/hydai/eml2md.git
cd eml2md
cargo build --release

The binary will be available at target/release/eml2md.

Usage

eml2md -i <input.eml> -o <output.md> [-f <format>]

Options

Example

# Convert email to markdown
eml2md -i email.eml -o email.md

# Use HTML format
eml2md -i email.eml -o email.md -f html

Output Format

The generated Markdown includes a metadata table and the email body:

|||
|---|---|
|From|John Doe <john@example.com>|
|To|Jane Doe <jane@example.com>|
|CC||
|Date|2024-01-01 12:00:00|
|Subject|Meeting Notes|

Hello,

This is the email body content...

Development

Prerequisites

• Rust (2024 edition)
• Cargo

Building

# Development build
cargo build

# Release build
cargo build --release

Code Quality

# Run all checks
make all

# Individual checks
make lint     # Format check (cargo fmt --all --check)
make clippy   # Linter (cargo clippy --all-targets --all-features)
make build    # Build project

Testing

cargo test

Project Structure

eml2md/
├── src/
│   ├── main.rs          # CLI entry point
│   ├── lib.rs           # Library exports
│   ├── eml.rs           # EML parsing (Email, Header, Body, Attachment)
│   ├── content_type.rs  # MIME type parsing
│   └── formatter/
│       ├── mod.rs       # Formatter trait and factory
│       └── simple.rs    # SimpleFormatter & SimpleHtmlFormatter
├── tests/
│   └── example/         # Example EML files for testing
├── Cargo.toml
└── Makefile

Dependencies

License

Apache-2.0

Author

hydai