{"id":38860207,"url":"https://github.com/shuckster/denote-md","last_synced_at":"2026-01-17T14:21:17.278Z","repository":{"id":219197730,"uuid":"747931726","full_name":"shuckster/denote-md","owner":"shuckster","description":"Shell script for Denote's Markdown + YAML variant","archived":false,"fork":false,"pushed_at":"2024-08-25T08:09:53.000Z","size":159,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-25T09:25:56.066Z","etag":null,"topics":["note-taking","shell","vim-plugin","zettelkasten"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/shuckster.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":"2024-01-24T23:21:47.000Z","updated_at":"2024-08-25T08:09:56.000Z","dependencies_parsed_at":"2024-01-26T01:34:32.233Z","dependency_job_id":"99c4e039-ed98-4966-af9d-133cea6d98d4","html_url":"https://github.com/shuckster/denote-md","commit_stats":null,"previous_names":["shuckster/denote-md"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/shuckster/denote-md","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shuckster%2Fdenote-md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shuckster%2Fdenote-md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shuckster%2Fdenote-md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shuckster%2Fdenote-md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shuckster","download_url":"https://codeload.github.com/shuckster/denote-md/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shuckster%2Fdenote-md/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28509942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["note-taking","shell","vim-plugin","zettelkasten"],"created_at":"2026-01-17T14:21:16.938Z","updated_at":"2026-01-17T14:21:17.245Z","avatar_url":"https://github.com/shuckster.png","language":"Shell","funding_links":["https://www.buymeacoffee.com/shuckster"],"categories":[],"sub_categories":[],"readme":"# denote-md\n\nShell script for Denote's Markdown + YAML variant.\n\nLatest version: 1.1.2\n\n\u003cimg alt=\"denote-md\" src=\"./screenshot.png\" width=\"500\" /\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eDenote TL;DR:\u003c/summary\u003e\n\nIt's a note-taking system designed to work well even with basic file-system tools like `ls` and `grep`.\n\nThe file-name format:\n\n```\n20210319T202401--single-responsibility__software_solid_zettel.md\n^_____________^  ^___________________^  ^___________________^\n      id                 title                   tags\n```\n\nThe front-matter:\n\n```md\n---\nidentifier: \"20210815T234244\"\ndate: 2021-08-15T23:42:44.000Z\ntags: [ \"software\", \"javascript\", \"zettel\" ]\ntitle: \"Currying\"\n---\n```\n\nThe links between notes:\n\n```\nHop along to [[denote:20210815T234244]] for more info...\n```\n\n\u003c/details\u003e\n\nOnce installed, configure these paths:\n\n```sh\nexport DENOTE_MD_SCRIPT_PATH=/path/to/denote-md.sh\nexport DENOTE_MD_NOTES_PATH=/path/to/your/notes/folder/\n```\n\n---\n\nDenote was written by Protesilaos Stavrou and is documented here:\n- https://protesilaos.com/emacs/denote\n\nThis script, denote-md, implements Denote in its Markdown-with-YAML\nfront-matter variant only, with a couple of extra features that the author\nfinds personally useful. It was written by Conan Theobald.\n\nThere is a companion Vim plugin available.\n- https://github.com/shuckster/vim-denote-md\n\nCLI usage:\n\n```\nUsage: denote-md.sh [-g] \u003ccommand\u003e [\u003cargs\u003e]\n\n  new                 [tags] [title]\n  get      filename   [identifier]\n  get      title      note.md\n  replace  title      [new_title] *.md\n\n  list     tags       [*.md]\n  list     notes      [tags]\n  list     recent     [num_notes]\n  list     backlinks  note.md\n  list     heading    [heading] [tags]\n  list     actions    [tags]\n\n  add      tag        [tag] *.md\n  remove   tag        [tag] *.md\n  rename   tag        [tag] [new_name] *.md\n  replace  tags       [new_tags] *.md\n\n  refresh             *.md\n\n  env                 Print environment variables\n```\n\nCommands that accept globs can also read files from `stdin`, eg:\n\n```\nls *.md|denote-md list tags\n```\n\nPrefixing a command with `-g` will enable colour for any printed filenames.\n\nExcept for `new`, commands with missing arguments will print help and an\nexample for that command. The `new` command will prompt for missing arguments.\n\nNo command is confirmed before being executed, so please use in combination\nwith version control. You have been warned.\n\n## Credits\n\nProps to\n[u/varsderk](https://www.reddit.com/r/vim/comments/17vm4i8/re_denote_for_vim_fineill_make_a_crappy_version/)\nfor introducing me to [denote](https://protesilaos.com/emacs/denote).\n\n`denote-md` was written by [Conan Theobald](https://github.com/shuckster/).\n\nI hope you found it useful! If so, I like [coffee ☕️](https://www.buymeacoffee.com/shuckster) :)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshuckster%2Fdenote-md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshuckster%2Fdenote-md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshuckster%2Fdenote-md/lists"}