用途:把 Markdown 内容(文件或内联文本)转换成完整、自包含的 HTML 邮件,便于粘贴进任意邮件发送工具,兼顾 Gmail、Outlook、Apple Mail 等客户端兼容性。
主要能力:解析 YAML frontmatter 配置 preheader、brand-color、heading/body/background 颜色、字体、字号、行高、内容宽度、header-logo、footer-text 等(均有默认值);将标题、段落、加粗斜体删除线、链接、有序/无序/任务列表、行内代码、代码块、引用、图片、分隔线、高亮映射为邮件安全组件;支持 :::hero、:::callout[type]、:::buttontext、:::button.secondary、:::centered、:::footer 等指令;使用表格布局、内联 CSS,并为按钮附 VML 回退、为最大宽度加 Outlook 条件注释。
使用方式:提供 .md 文件路径或粘贴 Markdown;若都无则询问。加载 references 下的兼容性与组件参考后,按 frontmatter 替换 {{变量}},输出完整 HTML。文件输入时在同目录生成同名 .html;内联输入时需向用户询问输出路径。最后报告输出路径、所用主题值与警告。
限制:正文中不得放 <style>(Gmail 会剥离),仅 <head> 可用于响应式媒体查询;不支持 flexbox、grid、CSS 变量;不用 <button>,改用样式化的 <a>;禁用 JavaScript 与外部 CSS;仅用 px 单位(不用 rem、em、vh、vw、calc);图片必须显式设置宽高;src 与 href 必须为绝对 URL。部分不支持的 Markdown 特性可能被跳过。