Link Queries

Neuron supports link queries that can be used to dynamically create links based on a tag (see Tags).

For example, to link to all zettels with the “science” tag (from the example at Zettel metadata), you would add the following to your note:


When neuron encounters an URI with the z: protocol such as the above, it treats it as a link query. The z:zettels query in particular will link to all zettels tagged with the tag specified in the tag query parameter.

Tip: You can use the CLI to see which zettels will be included in a given query; see Querying with JSON output.


Here is a list of zettels tagged “walkthrough” on this very Zettelkasten:


The above list was produced by the link query [[z:zettels?tag=walkthrough]].1

Hierarchical tags

Queries can also link to zettels whose Tags match a glob pattern. Two kinds of patterns in particular are noteworthy:

  1. Simple globs: Simple globs (*) can be used to query all tags at a particular level in the hierarchy. For instance, [[z:zettels?tag=science/*]] will link to all zettels tagged “science/physics” and “science/biology”, but not “science/physics/kinematics”.

  2. Recursive globs: Recursive globs (**) are like simple globs, but they operate recursively, matching tags at all levels in the hierarchy. For instance, [[z:zettels?tag=science/**]] will also match “science/physics/kinematics”. This will also include zettels that are tagged “science” only, though this behavior can be avoided by querying “science/*/**” instead.

For a real-world example of link queries and hierarchical tags, see Alien Psychology (source).

Control flags

Link queries support a few query flags to control the link listing UI:

  • ?grouped: Group the results by matching tag (use with hierarchical tags)
  • ?timeline: Sort the results by date from Zettel metadata, and also display the date.
  • ?showid: Display the zettel ID alongside the zettel title (link).
  1. Note that here we use [[..]] to not affect the Folgezettel Heterarchy of the graph; whereas if we had used [[[...]]], it would have formed the appropriate folgezettel connections to the listed notes (which is not what we want on this note).