Yarle 开源项目教程
项目介绍
Yarle 是一个开源项目,旨在将 Evernote 笔记转换为 Markdown 格式。这个工具对于希望将笔记迁移到支持 Markdown 的笔记应用(如 Obsidian、Joplin 等)的用户来说非常有用。Yarle 支持多种输出格式和配置选项,使得笔记转换过程既灵活又高效。
项目快速启动
安装 Yarle
首先,确保你已经安装了 Node.js。然后,通过以下命令安装 Yarle:
npm install -g yarle-evernote-to-md
使用 Yarle
- 创建一个配置文件
config.json
,可以根据需要调整配置选项。以下是一个基本的配置示例:
{
"outputDir": "./output",
"allowParentNotebooks": true,
"allowAttachments": true,
"keepOriginalAmounts": false,
"useHashInsteadOfId": false,
"nestedTags": {
"separatorInEN": "_",
"replaceSeparatorWith": "/"
},
"metadataOptions": {
"generateYarleMetadata": true,
"keepOriginalDate": false,
"useTitleAsFilename": true,
"useUUIDAsFilename": false
}
}
- 运行 Yarle 进行转换:
yarle --config config.json --inputFile your-evernote-export.enex
应用案例和最佳实践
应用案例
- 学术研究者:将 Evernote 中的研究笔记转换为 Markdown,便于在学术论文中引用和管理。
- 软件开发者:将技术笔记和代码片段转换为 Markdown,方便在 GitHub 或其他代码托管平台上分享和协作。
- 内容创作者:将 Evernote 中的创作草稿转换为 Markdown,便于在各种内容管理系统中发布。
最佳实践
- 定期备份:定期将 Evernote 笔记导出为
.enex
文件,并使用 Yarle 进行转换,确保笔记数据的安全性和可迁移性。 - 自定义配置:根据个人需求调整
config.json
文件,例如设置输出目录、处理附件和标签等。 - 版本控制:将转换后的 Markdown 笔记纳入版本控制系统(如 Git),便于跟踪和管理变更。
典型生态项目
- Obsidian:一个基于 Markdown 的笔记应用,支持双向链接和强大的知识图谱功能。
- Joplin:一个开源的笔记和待办事项应用,支持 Markdown 和端到端加密。
- Zettlr:一个面向学者和作家的 Markdown 编辑器,支持文献管理和导出功能。
通过 Yarle 将 Evernote 笔记转换为 Markdown 格式,可以无缝集成到这些生态项目中,提升笔记管理和协作的效率。