Comment Directive

Tombi supports comment directives to control the behavior of the document.

There are two types of comment directives with different scopes of application:

TypeDirectiveScope
Document Comment Directive#:schema, #:tombiDocument
Value Comment Directive# tombi:Value

Document Comment Directive

Document comment directives are comments that apply to the entire document. These only work in the comment group at the beginning of the document.

  • #:schema - Specify JSON Schema for validation
  • #:tombi - Document-level configuration (TOML version, format/lint/schema options)

Value Comment Directive

Value comment directives are comments that apply to a specific value, allowing fine-grained control over formatting and linting rules.

  • # tombi: - Value-level configuration (format rules, lint rules)