Expression Syntax

You can use expressions to use dynamic content in your docs, or conditionally show specific content.

Here is a simple example:

{ "bob" | capitalize }

This would render: Bob .

NOTE : Dynamic expressions and components aren't supported inside code blocks, in order to prevent clashes with any languages with similar syntax.

Filters

Filters are ways for you to transform values inside expressions. You can call filters like functions in most programming languages:

capitalize("docs")  # => "Docs"

But you can also use a pipeline syntax, where values flow from one filter to another in sequence:

"docu" | capitalize | append("mentation") # => "Documentation"

You can find the list of supported filters here ›

Types

Doctave's expression language supports the following basic types:

• Strings

• Integers

• Floats

• Boolean values

• Lists (coming soon)

• Objects (coming soon)

• Null

Truthiness

All values are truthy , except for null and false . This allows you to for example set a default value in case a variable is null:

{ @maybe_null || "Default value" }