Katvan supports overriding editor settings on a per-document basis by the use modelines. These are modeled after, and compatible with, the modelines used by Kate.

A modeline is a line with starts with the either the prefix katvan: or the prefix kate: and followed by a semicolon separated list of configuration variables to be overridden for the containing file and their new value. Multiple modelines are allowed in the same file - setting values that appear later take precedence. To avoid compilation issues, modelines should of course be placed within Typst comments.

Examples:

// katvan: replace-tabs on; indent-width 4;

/* kate: font-size 14; font Arial; */

• Only modelines that appear in the first 10 lines of a file are considered.
• Changes to modeline values become effective on the next file save.
• Unrecognized variable names, or variables with invalid values, are ignored.
• A trailing semicolon is not mandatory, but is important for eliminating ambiguity on the end of a modeline - especially if in a multi-line comment.

For these variables, there are three types of supported values:

• BOOL: one of on, true or 1 to enable, or off, false or 0 to disable.
• INTEGER: any decimal integer value (although some variables may have additional restrictions).
• STRING: everything else.