{"id":17026265,"url":"https://github.com/kevboh/export-ulysses","last_synced_at":"2025-09-07T15:39:54.409Z","repository":{"id":143161191,"uuid":"141070200","full_name":"kevboh/export-ulysses","owner":"kevboh","description":"Exports your Ulysses library as markdown files.","archived":false,"fork":false,"pushed_at":"2018-12-10T02:36:21.000Z","size":8,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T06:11:39.047Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kevboh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-16T01:04:49.000Z","updated_at":"2024-12-07T11:48:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"0de7a29e-1b29-440b-80a6-281d7050ca35","html_url":"https://github.com/kevboh/export-ulysses","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fexport-ulysses","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fexport-ulysses/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fexport-ulysses/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fexport-ulysses/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevboh","download_url":"https://codeload.github.com/kevboh/export-ulysses/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248560070,"owners_count":21124590,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T07:31:23.730Z","updated_at":"2025-04-12T11:33:08.438Z","avatar_url":"https://github.com/kevboh.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# export-ulysses\n\nExports your Ulysses library as markdown files.\n\n- Preserves bold, italics, links, code blocks, and strikethroughs.\n- Annotations precede their attached text by a colon, so an annotation on the word **bloom** with text \"See wordnik for more\" becomes:\n  \u003e See wordnik for more: bloom.\n- Exported markdown files have creation and modification dates that match your notes.\n- A meta text section is included (by default, can be turned off) in each note wherein export date, creation/modification dates, note keywords, and attachment filenames are recorded.\n\n## Installing\n\nexport-ulysses is written in Swift 4.2 (I was curious). You’ll need to [install Xcode](https://developer.apple.com/xcode/) to build it.\n\n```\ngit clone git@github.com:kevboh/export-ulysses.git\ncd export-ulysses\nswift run export-ulysses --help\n```\n\nIf you plan to do this often, you may want to build a release binary with `swift build -c release` and copy it into your PATH.\n\n## Usage (--help)\n\n```\nUsage:\n\n    $ export-ulysses \u003cinput\u003e \u003coutput\u003e\n\nArguments:\n\n    input - The path to your Ulysses notes. See README for hints on what this might be.\n    output - The path you want to export notes to.\n\nOptions:\n    --keep-groups [default: false] - Create directories for each Ulysses Group, and export notes into them.\n    --skip-meta [default: false] - Don’t append Ulysses keywords, attachment info, create date, and modify date to files. Files will still have the correct system create and modify dates.\n    --verbose [default: false] - Log export activity and debugging statements.\n```\n\n### Okay, give me those input hints\n\nIf you don’t use iCloud, your notes are probably at `~/Library/Containers/com.soulmen.ulysses3/Data/Documents/Library/`.\n\nIf you do use iCloud, your notes are probably at `~/Library/Mobile Documents/X5AZV975AG~com~soulmen~ulysses3/Documents/Library/`. You can’t view that directory in the Finder, so if you need to hunt for it you should probably do so in Terminal.app.\n\n## Some Caveats!\n\n1.  While this tool works on my Ulysses library, I built it specifically to crash when something unexpected pops up. A Ulysses-flavored Markdown feature/tag I never happened to use, for example. If that happens to you, please file an issue or, better yet, a PR!\n2.  Images are not currently supported, only logged in note text as having been present, e.g. `(image with ID xyz)`. I have a pretty good idea of how to support them, though, so if you need them I could probably make it happen.\n3.  File attachments are not supported, but their file names are logged in the appended meta text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevboh%2Fexport-ulysses","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevboh%2Fexport-ulysses","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevboh%2Fexport-ulysses/lists"}