Yarle：Evernote 笔记转 Markdown 工具

项目简介

Yarle（Yet Another Rope Ladder from Evernote）是一款把 Evernote 导出文件转换成 Markdown 的工具，提供带图形界面的桌面应用，也可以作为命令行工具运行。它面向希望离开 Evernote、把多年笔记迁移到 Obsidian、Logseq、Tana、Heptabase、NotePlan、Craft 等支持 Markdown 的笔记应用的用户。

主要功能

Yarle 可以转换：

• 任意文本内容
• 全部元数据：原始创建时间、最后修改时间、标签、GPS 位置、笔记本名称、来源 URL
• 外部链接
• Evernote 笔记之间的内部链接
• 代码块
• 内嵌图片
• 附件
• 网页剪藏（Webclips）

支持的输入：

• 单个 enex 文件（从 Evernote 导出的一个笔记本）
• 一个包含多个 enex 文件的文件夹（多个笔记本导出后放在同一目录）

高度可定制：

• 按用户自定义模板生成 Markdown 文件，详见 How to use templates with YARLE
• 可将 title、创建时间、更新时间、标签、经纬度、来源、笔记本、原始 HTML 链接等作为元数据写入 md（需配置自定义模板）
• 按笔记原始的创建／访问／修改时间更新生成的 md 文件时间戳
• 把所有附件整理到 _resources 子目录，保持笔记目录简洁
• 针对 Obsidian、Logseq 等应用提供专门的目标格式设置

安装与使用

桌面应用

在 Releases 页面按操作系统下载对应安装包，双击运行即可：

平台	下载
macOS	yarle-evernote-to-md_mac_arm64.zip
Windows	yarle-evernote-to-md_win_x64.exe
Linux (.rpm)	yarle-evernote-to-md_linux_x86_64.rpm
Debian (.deb)	yarle-evernote-to-md_linux_amd64.deb

macOS 上首次运行需右键点击并选择「运行」来打开，因为系统会阻止直接运行从网络下载的应用。

若要把笔记转换成 Logseq 格式，在配置面板中把 Target format 选为 Logseq，再选择笔记类型（Journal Notes 或 Pages）；Logseq 相关的其他选项已预先配置好。

命令行方式

在终端中准备一个配置文件（配置项见下文），然后执行：

npx -p yarle-evernote-to-md@latest yarle --configFile <path_to_your_file e.g. ./config.json>

配置

使用前需要创建配置文件，默认结构如下：

{
    "enexSources": [
       "/absolute-path-of-your-enex-dir/test-template.enex"
       ],
    "templateFile": "/absolute-path-of-your-template-dir/sampleTemplate.tmpl",
    "outputDir": "/path-of-your-desired-output-folder",
    "isZettelkastenNeeded": false,
    "useZettelIdAsFilename": false,
    "plainTextNotesOnly": false,
    "skipWebClips": true,
    "useHashTags": true,
    "outputFormat": "StandardMD",
    "taskOutputFormat": "StandardMD",
    "urlEncodeFileNamesAndLinks": false,
    "skipEnexFileNameFromOutputPath": false,
    "monospaceIsCodeBlock": false,
    "keepMDCharactersOfENNotes": false,
    "keepOriginalAmountOfNewlines": false,
    "addExtensionToInternalLinks": true,
    "trimStartingTabs": false,
    "convertPlainHtmlNewlines": false,
    "encryptionPasswords": [],
    "nestedTags": {
      "separatorInEN": "_",
      "replaceSeparatorWith": "/",
      "replaceSpaceWith": "-"
   },
   "replacementCharacterMap": {
      "<": "_",
      ">": "_",
      ":": "_",
      "\"": "_",
      "/": "_",
      "\\": "_", 
      "|": "_",
      "?": "_",
      "*": "_"
    },
   "globalReplacementSettings": [
        {
         "type": "title" ,
         "regex": "X",
         "replace": "<replaced_X>"
         },
        {
         "type": "content",
         "regex": "a",
         "replace": "<replaced_a>"
        }
      ],
   "resourcesDir": "resources",
   "turndownOptions": {
      "headingStyle": "atx"
   },
   "dateFormat": "YYYY-MM-DD",
   "haveEnexLevelResources": true,
   "haveGlobalResources": false,
   "useUniqueUnknownFileNames": false,
   "useLevenshteinForLinks": false,
   "convertColorsToMDHighlight": false,
   "logseqSettings": {
        "journalNotes": false
    },
   "obsidianSettings": {
      "omitLinkDisplayName": false
    }
}

注意事项

• macOS 若提示应用「已损坏」而拒绝运行，可参考 该问题的解决方案。
• 转换到 Tana 时存在一些细节限制，README 中有专门说明（Tana limitations 小节）。
• 加密笔记需要在配置中提供 encryptionPasswords 才能处理。
• 元数据字段要写入 md，必须自行配置自定义模板。

更多入门与使用演示可参考视频：How to migrate notes from Evernote to Obsidian (using Yarle)、YARLE: A lifeline to escape from Evernote。

---

本作品整理自 GitHub 开源项目 akosbalasko/yarle，原作者 @akosbalasko，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。