相关职业SOC
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/fabioc-aloha/Alex_Plug_In --skill md-to-eml命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Create and maintain ASCII visual dashboards for project tracking with parallel lane progress bars
Store and manage voice samples for TTS cloning — portable, version-controlled audio references
Clear documentation through visual excellence
正在显示 SKILL.md
基于 SOC 职业分类
| name | md-to-eml |
| description | Convert Markdown to RFC 5322 email (.eml) with inline CSS and CID images |
| tier | extended |
| inheritance | inheritable |
| applyTo | **/*.eml,**/*email*,**/*newsletter* |
| muscle | .github/muscles/md-to-eml.cjs |
Write in Markdown, send as professional email — works in any email client
Convert Markdown documents with YAML frontmatter into RFC 5322-compliant .eml files ready for governance, newsletter, and stakeholder communication workflows.
| Format | Status | Notes |
|---|---|---|
| Headings | ✅ | H1-H6 with inline styles |
| Bold/Italic | ✅ | Standard emphasis |
| Links | ✅ | Clickable hyperlinks |
| Images | ✅ | CID embedded as attachments |
| Code blocks | ✅ | Monospace, gray background |
| Inline code | ✅ | Highlighted |
| Tables | ✅ | HTML tables with borders |
| Blockquotes | ✅ | Indented with border |
| Lists | ✅ | Ordered and unordered |
| Mermaid diagrams | ⚠️ | Table fallback (no JS in email) |
| Emoji | ✅ | Unicode preserved |
| Horizontal rules | ✅ | Styled dividers |
| Feature | Details |
|---|---|
| YAML frontmatter | Maps to RFC 5322 headers (To, From, Subject, CC, Reply-To) |
| Email-safe HTML | Inline CSS with table-based layout (no <style> blocks) |
| Mermaid fallback | Diagrams converted to ASCII table representation (email-safe) |
| CID images | Local images embedded as base64 multipart MIME attachments |
| Emoji preservation | Subject and body emoji render correctly across clients |
| Test mode | --test flag overrides recipients for safe preview |
# Basic conversion
node .github/muscles/md-to-eml.cjs newsletter.md
# With test recipient override (safe preview)
node .github/muscles/md-to-eml.cjs newsletter.md --test --test-to me@example.com
# Embed images as CID attachments
node .github/muscles/md-to-eml.cjs update.md --inline-images
# Debug mode (saves intermediate HTML)
node .github/muscles/md-to-eml.cjs update.md --debug
| Option | Default | Description |
|---|---|---|
--test | off | Override recipients for safe preview |
--test-to ADDRESS | frontmatter from | Custom test recipient email |
--inline-images | off | Embed images as base64 CID attachments |
--debug | off | Save intermediate HTML for inspection |
The YAML frontmatter maps directly to RFC 5322 email headers:
---
to: team@example.com
from: sender@example.com
subject: 📊 Weekly Update - Sprint 42
cc: manager@example.com
reply-to: noreply@example.com
---
| Field | RFC 5322 Header | Required | Notes |
|---|---|---|---|
to | To | ✅ | Primary recipient(s), comma-separated |
from | From | ✅ | Sender address |
subject | Subject | ✅ | Supports emoji |
cc | Cc | ❌ | Carbon copy recipients |
reply-to | Reply-To | ❌ | Reply address if different from From |
| Client | HTML | Images | Tables | Emoji |
|---|---|---|---|---|
| Outlook (Windows) | ✅ | ✅ CID | ✅ | ✅ |
| Outlook (Mac) | ✅ | ✅ CID | ✅ | ✅ |
| Gmail (Web) | ✅ | ✅ CID | ✅ | ✅ |
| Apple Mail | ✅ | ✅ CID | ✅ | ✅ |
| Thunderbird | ✅ | ✅ CID | ✅ | ✅ |
| Mobile (iOS/Android) | ✅ | ⚠️ varies | ✅ | ✅ |
--test --test-to your@email.com--test for productionEmail clients cannot execute JavaScript, so Mermaid diagrams are converted to text-based table representations:
┌─────────────────┐
│ Original Mermaid │ → Table Fallback
└─────────────────┘
flowchart LR → | Step | Description |
A --> B | A | Start |
B --> C | B | Process |
| C | End |
For high-fidelity diagrams, pre-render to PNG and include as images.
| Problem | Cause | Solution |
|---|---|---|
| "pandoc not found" | pandoc not installed | winget install pandoc |
| Images not showing | CID not supported | Use --inline-images flag |
| Formatting broken | Client strips styles | Use simpler formatting |
| Large file size | Too many images | Link images instead of embedding |
| Subject truncated | Too long | Keep under 60 characters |
| Emoji not showing | Old email client | Use text alternatives |
markdown-preprocessor.cjs, mermaid-pipeline.cjs.github/muscles/md-to-eml.cjs (v1.0.0)
Skill version: 2.0.0 | Last updated: 2026-04-14 | Category: document-conversion