Specifies nodes to include when building a dynamic output.
INCLUDE([ parameter; parameter; ... ] [ flags ... ])
shorthand:
+([ parameter; parameter; ... ] [ flags ... ])
Use semicolon or newline to separate the arguments.
Example
[[ …
INCLUDE(keyword = example value)
…
]]
INCLUDE(keyword = example value)
…
]]
Parameters
key name
operator
value
key name
may be:- any key name in the project, including system keys
*
matches “any key”
operator
may be one of:=
“equals / is”?
“contains”before
“is before” (for comparing Timestamps)after
“is after” (for comparing Timestamps)
value
may be:- any metadata value in — or not in — the project. Values not in the project will return empty results
*
matches “any value”
*
with no operator will include all nodes in the project
When multiple parameters are included in a single INCLUDE() directive, only the nodes meeting all are included.
To include nodes from multiple independent parameters, use multiple INCLUDE() directives.
Flags
-title_only
: includes nodes that contain only a title, no additional text. See Node Titles for more information.-untitled
: includes only untitled nodes (nodes with no text except metadata, dynamic definitions, or embedded/escaped syntax.-is_meta
: includes only nodes for which the value(s) of the key and operator are themselves a node. See Nodes as Metadata Values.-is_not_meta
: includes only nodes for which the value(s) of the key and operator are not a node.-dynamic
: includes dynamic nodes. Not included by default.