{"id":13707013,"url":"https://github.com/vifon/zettel-mode","last_synced_at":"2025-07-23T11:05:01.154Z","repository":{"id":140479593,"uuid":"266890129","full_name":"vifon/zettel-mode","owner":"vifon","description":"A Zettelkasten-style note-taking helper","archived":false,"fork":false,"pushed_at":"2022-06-26T23:36:16.000Z","size":109,"stargazers_count":33,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-06T18:52:13.557Z","etag":null,"topics":["emacs","org-mode","roam","zettelkasten"],"latest_commit_sha":null,"homepage":null,"language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vifon.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}},"created_at":"2020-05-25T22:12:31.000Z","updated_at":"2024-09-12T06:32:26.000Z","dependencies_parsed_at":"2024-01-14T20:34:16.287Z","dependency_job_id":null,"html_url":"https://github.com/vifon/zettel-mode","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/vifon/zettel-mode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Fzettel-mode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Fzettel-mode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Fzettel-mode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Fzettel-mode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vifon","download_url":"https://codeload.github.com/vifon/zettel-mode/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Fzettel-mode/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266665790,"owners_count":23964973,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["emacs","org-mode","roam","zettelkasten"],"created_at":"2024-08-02T22:01:15.134Z","updated_at":"2025-07-23T11:05:01.102Z","avatar_url":"https://github.com/vifon.png","language":"Emacs Lisp","funding_links":[],"categories":["Uncategorized","Emacs Lisp","Software"],"sub_categories":["Uncategorized"],"readme":"zettel-mode [name subject to change]\n====================================\n\nNote: Mostly superseded by\n[zettel2](https://github.com/vifon/zettel2).  Left as a separate\nproject because the featureset is very different.\n\nAn opinionated Emacs mode for [Zettelkasten][1]-style note-taking.\nHeavily inspired by [org-roam][2], striving to be simpler, less\ndependent on the external state (like the auxiliary database of\n`org-roam`) and local only to the affected files (i.e. no global minor\nmodes).\n\nASSUMPTIONS\n-----------\n\nTraditionally uses [Deft][3] as its \"entry point\" and was initially\ndeveloped under an assumption the `Deft` files reside in `~/.deft/`.\nIt should work with any `deft-directory` but you'll need to customize\n`auto-mode-alist` accordingly.  Using subdirectories isn't supported.\n\nIt's possible to have secondary Zettelkastens outside of `~/.deft/`,\nor ignore Deft whatsoever by handling `auto-mode-alist` manually, for example:\n\n```elisp\n;;; Any .org file inside a zettel/ or zettels/ directory.\n(add-to-list 'auto-mode-alist '(\"/zettels?/[^/]+\\\\.org\\\\'\" . zettel-mode))\n\n(add-to-list 'auto-mode-alist '(\"/home/USER/my-zettelkasten/[^/]+\\\\.org\\\\'\" . zettel-mode))\n```\n\nTo prevent `zettel-mode` from associating with the Deft files, eval\n`(setq zettel-mode-no-deft t)` before loading `zettel-mode`.\n\n[1]: https://zettelkasten.de/\n[2]: https://github.com/org-roam/org-roam\n[3]: https://github.com/jrblevin/deft\n\nFEATURES\n--------\n\n- Quick new note creation: select some text and press \u003ckbd\u003eC-c C-l\u003c/kbd\u003e.\n- A sidebar with lists of references to and from the current file.\n- A fully optional reference and backreference cache (rebuilt with `make(1)`).\n\nFor the settings see the provided [Customize][4] menus.\n\n[4]: https://www.gnu.org/software/emacs/manual/html_node/emacs/Easy-Customization.html\n\nSCRIPTS\n-------\n\nIn the `scripts/` directory reside some helper scripts for common\nmaintenance tasks for the notes.  In general they work but they\nprobably don't handle all the corner cases (like filenames with\nspecial characters).  Each script has a brief description included as\na comment.\n\nFAQ\n---\n\nQ: Why it's not on MELPA?\n\nA: I don't want to hoard such a generic name as `zettel-mode` and for\nnow I don't have a better name for it either.\n\nCOPYRIGHT\n---------\n\nCopyright (C) 2020  Wojciech Siewierski\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvifon%2Fzettel-mode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvifon%2Fzettel-mode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvifon%2Fzettel-mode/lists"}