A bunch of features for analysing markdown notes that I find myself going back to over and over again, wrapped up in a single tool.
complexity, size, and headercount let me evaluate which notes may contain
too many ideas, and therefore are perhaps suitable for revision for splitting
into a more zettelkasten style.
structure is useful for being able to quickly get an idea of a note has the
kind of content I'm searching for.
links is useful for ensuring that my notes don't degrade over time (either
through me renaming files and thus breaking links, or websites going offline or
redirecting).
tags utilises my tagsearch library to identify keywords of the pattern
@[a-zA-Z1-9]+ in the text. I can then loosely group files matching a given set
of tags, e.g. an tags -t work project -n thesis to show work projects but
not my thesis.
untagged utilises my tagsearch library to identify files which don't contain
any tags.
an complexity <files>...
A heuristic on the number of headers and lines of content within each header.
Roughly, sum_of_all_header_levels / num_headers (e.g. if you have 1 H1, 2 H2,
2 H3, then the sum 1 + 4 (2x2) + 6 (2x3), divided by 5 (1+2+2). Sorted by
complexity.
an headercount <files>...
How many headers are in the file. Sorted output.
an size <files>...
Filesize in bytes. Sorted output.
an search <word>...
Search for each of word across 1) file titles, 2) file contents, 3) file tags.
- Words starting with
@will be searched in title and tags. - Words not starting with
@will be searched in title and contents
an structure <files>...
Table of Contents of each file (list of headers).
an links <files>... [-l|--local]
Check all links within the file, including check for existance of local links.
-l argument to only check local links.
an tags <files>... [-t <tags-to-match> -n <tags-to-not-match>]
Show tags for all files. With -t, filter to only files including all of the
tags to match. With -n, filter to files that don't contain any of the tags
to not match. -t and -n can be both used, and are applied sequentially (i.e.
filter all that match, then remove those that we don't want to match).
an untagged <files>...
Show all files that don't have a tag.