Code Monkey home page Code Monkey logo

yarle's Introduction

logo

Last Commit Version Documentation Maintenance License: MIT GitHub All Releases

Yarle is the ultimate converter of Evernote notes to Markdown.

Features:

Yarle can convert:

  • ๐Ÿ“ Any text
  • ๐Ÿ“ All metadata: original creation time, last modification time, tags, GPS location, notebook name, source URL
  • ๐Ÿ”— External links
  • ๐Ÿ”— Internal links among Evernote notes
  • ๐Ÿ’ป Codeblocks
  • ๐Ÿ–ผ๏ธ Inline Images
  • ๐Ÿ“Ž Attachments
  • ๐Ÿ“„ Webclips

Works with:

  • ๐Ÿ““ single enex file (one notebook exported from Evernote)
  • ๐Ÿ“š or a folder of enex files supported (several notebooks exported and placed into the same folder locally)

Highly customizable:

  • ๐Ÿš€ Creates Markdown files matching to user-defined templates, see Templates introduced. See How to use templates with YARLE for details.
  • ๐Ÿ’ก Metadata support: Puts title, creation time, update time, tags, and latlong source, notebook, link to original html meta-information into md as metadata. (To set them, please set up a custom template)
  • ๐Ÿ”จ Updates md files' creation, access, and modification timestamps according to the notes' original create/update/modification time.
  • ๐Ÿ”จ Organizes all attachments into a _resources subfolder (to keep the notes' folder as simple as possible).

Binaries:

Windows

Linux (.rpm)

Debian (.deb)

Mac

Feedback, Appreciation, Donation:

If you have an idea on how to improve the tool or face any problems, feel free to raise an issue, or even contribute! If you like the product, you can give a star here on github, or you can Buy Me A Coffee

Yarle's supporters said:

from Someone
Thanks, this really helped me out of evernote!

YARLE has just allowed me to transfer several years-worth of Evernote notes to Obsidian painlessly and astonishingly quickly. Your work has made my day. Thank you.

from @opscat
Thanks so much!

Proud to be proposed by:

drawing drawing drawing drawing drawing

Instructions

Download the desktop app for your platform, and follow the instructions there.

yarle.5.0.demo.mov

In order to perform conversion into Logseq format, please choose Logseq as Target format in the configuration panel, then choose the type of your notes (Journal Notes or Pages). For Logseq all the other options have already been pre-configured.

Prerequisite for legacy versions (below 4.0.0):

Zero-install execution via command line

Just open a terminal, specify config options in a config file (options detailed in Configuration) and type the following:

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

Configuration:

To configure Yarle, you must create a config file. By default it looks like this:

{
    "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": false,
    "useHashTags": true,
    "outputFormat": "StandardMD",
    "taskOutputFormat": "StandardMD",
    "urlEncodeFileNamesAndLinks": false,
    "skipEnexFileNameFromOutputPath": false,
    "monospaceIsCodeBlock": false,
    "keepMDCharactersOfENNotes": false,
    "keepOriginalAmountOfNewlines": false,
    "addExtensionToInternalLinks": true,
    "nestedTags": {
      "separatorInEN": "_",
      "replaceSeparatorWith": "/",
      "replaceSpaceWith": "-"
   },
   "resourcesDir": "resources",
   "turndownOptions": {
      "headingStyle": "atx"
   },
   "dateFormat": "YYYY-MM-DD",
   "haveEnexLevelResources": true,
   "haveGlobalResources": false,
   "useUniqueUnknownFileNames": false,
    "logseqSettings":{
        "journalNotes": false
    },
   "obsidianSettings": {
      "omitLinkDisplayName": false
    }

}

The following configurational properties are available: |

Property Name Property value Meaning
enexSources multiple enex files, or a folder of the enex files(if you specify it via command line) specifies the exported Evernote notebook(s) as an absolute path
templateFile path of your custom template file if its not specified, a default template will be used
outputDir path to your output dir (absolute or relative) this is the main output dir where the extracted markdown files and the external resources, images, pdf-s are going to be created
resourcesDir _resources subdir where attachments/external resources will be placed
isZettelkastenNeeded true or false puts Zettelkasten Id (based on time of creation) at the beginning of the file name
useZettelIdAsFilenameย  ย true or false Note files are named by their creation date (those are interpreted as zettelIds)
plaintextNotesOnly true or false skips any notes with attachments (e.g. notes containing pictures)
useHashTags true or false whether to add the pound sign in front of tags
outputFormat ObsidianMD or StandardMD generates internal file links and highlights in Obsidian-style: highlights are going to be bounded by == instead of ` characters, file links are going to be as follows: ![[file-name]] instead of ![file-name](file-name). Possible values: ObsidianMD to get Obsidian-style notes, StandardMD or skip it completely, if you prefer Standard Markdown format.
haveEnexLevelResources true or false stores note resources on global _resources folder per enex export if enabled
monospaceIsCodeBlock true or false if it's true then all deepest elements with monospace font style is recognized as Codeblocks
dateFormat ย string ISO 8601 specification of the expected date format (e.g. YYYY-MM-DD)
keepMDCharactersOfENNotes true or false set it true, if you used Markdown format in your EN notes
nestedTags it's a complex property contains the following subitems: "separatorInEN", "replaceSeparatorWith" and "replaceSpaceWith"ย  separatorInEN stores the tag separator used in Evernote, replaceSeparatorWith is the string to what separatorInEN should be replaced to, and replaceSpaceWith is the string to what the space character should be replaced to in the tags. For example using the default settings a tag tag1_sub tag of tag1 is going to be converted to tag1/sub-tag-of-tag1
keepImageSize ObsidianMD or StandardMD preserve an image's width and height in the chosen format when specified
urlEncodeFileNamesAndLinks true or false URL-encodes linked file names and internal EN links . e.g "linked file.jpg" will be converted to "linked%20file.jpg"
sanitizeResourceNameSpaces true or false Replace spaces in resource names with the replacementChar. e.g "linked file.jpg" will be converted to "linked_file.jpg"
replacementChar string the replacement character. e.g "linked*file.jpg" will be converted to "linked_file.jpg". It defaults to "_"
keepOriginalAmountOfNewlines true or false keep the original amount of newlines, default is false, when the multiple newlines are collapsed to one.
ย generateNakedUrls true or false if it's true, Yarle generates 'naked' external Urls without any extra characters. If its false, external Urls are wrapped by '<' and '>' characters
addExtensionToInternalLinks true or false adds '.md' extensions at the end of internal file links, to make them recognizable by DevonThink and other tools
turndownOptions {...} additional configuration options for turndown, e.g., { "bulletListMarker": "-" } (only in Yarle config file, not desktop app)
obsidianSettings {...} settings for Obsidian output. Currently, omitLinkDisplayName is supported. If set to true links will be of the form [[foo]]. Conversely they will be of the form `[[foo
logseqSettings ย {...} settings for Logseq output, currently journalNotes property is supported, if it is set to true, then the notes will be converted to be recognizable by Logseq as Journal notes, the notes will be named by their creation date and they will be collected under journal folder. If it is false, then they will be converted to be Pages (e.g. simple notes, collected in pages folder).
taskOutputFormat ObsidianMD or StandardMD Output format of Evernote v10+ tasks. ObsidianMD will connvert tasks to match with Obsidian Tasks plugin's requirements. StandardMD will create plain tasks, loosing many features like reminders or due dates.
obsidianTaskTag string a tag to put to a task converted from Evernote v10+ tasks. Optional by Obsidian Tasks plugin, pls check the details there.
useUniqueUnknownFileNames boolean ย generates a couple of random characters at the end of the resource file names if the exact name cannot be recognised. For instance: unknown_filename-d2fd86c3.pdf

Metadata settings can be set via the template.

Note links over notebooks? No problem, here is what to do:

In order to minimize the wrong conversion of links due to duplicated note names, you need to do the followings:

  1. Before export your notes: select all withing a notebook
  2. Create a Table of Contents note
  3. Export the notebook together with the TOC file
  4. Start yarle and convert your notes

yarle's People

Contributors

akosbalasko avatar rodbv avatar semantic-release-bot avatar cito avatar joaosa avatar dependabot[bot] avatar medmunds avatar aidin36 avatar sirspidey avatar acook avatar mbbroberg avatar mescalito avatar nikiluk avatar timjrobinson avatar grantx2016 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.