Skip to content

shuckster/denote-md

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 

Repository files navigation

denote-md

Shell script for Denote's Markdown + YAML variant.

Latest version: 1.1.0

denote-md

Denote TL;DR:

It's a note-taking system designed to work well even with basic file-system tools like ls and grep.

The file-name format:

20210319T202401--single-responsibility__software_solid_zettel.md
^_____________^  ^___________________^  ^___________________^
      id                 title                   tags

The front-matter:

---
identifier: "20210815T234244"
date: 2021-08-15T23:42:44.000Z
tags: [ "software", "javascript", "zettel" ]
title: "Currying"
---

The links between notes:

Hop along to [[denote:20210815T234244]] for more info...

Once installed, configure these paths:

export DENOTE_MD_SCRIPT_PATH=/path/to/denote-md.sh
export DENOTE_MD_NOTES_PATH=/path/to/your/notes/folder/

Denote was written by Protesilaos Stavrou and is documented here:

This script, denote-md, implements Denote in its Markdown-with-YAML front-matter variant only, with a couple of extra features that the author finds personally useful. It was written by Conan Theobald.

There is a companion Vim plugin available.

CLI usage:

Usage: denote-md.sh [-g] <command> [<args>]

  new                 [tags] [title]
  get      filename   [identifier]
  get      title      note.md
  replace  title      [new_title] *.md

  list     tags       [*.md]
  list     notes      [tags]
  list     recent     [num_notes]
  list     backlinks  note.md
  list     heading    [heading] [tags]
  list     actions    [tags]

  add      tag        [tag] *.md
  remove   tag        [tag] *.md
  rename   tag        [tag] [new_name] *.md
  replace  tags       [new_tags] *.md

  refresh             *.md

  env                 Print environment variables

Commands that accept globs can also read files from stdin, eg:

ls *.md|denote-md list tags

Prefixing a command with -g will enable colour for any printed filenames.

Except for new, commands with missing arguments will print help and an example for that command. The new command will prompt for missing arguments.

No command is confirmed before being executed, so please use in combination with version control. You have been warned.

Credits

Props to u/varsderk for introducing me to denote.

denote-md was written by Conan Theobald.

I hope you found it useful! If so, I like coffee ☕️ :)

About

Shell script for Denote's Markdown + YAML variant

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages