bun-flavored-toml.md

TOML is a minimal configuration file format designed to be easy for humans to read.

Bun implements a TOML parser with a few tweaks designed for better interoperability with INI files and with JavaScript.

; and # are comments

In Bun-flavored TOML, comments start with # or ;

# This is a comment
; This is also a comment

This matches the behavior of INI files.

In TOML, comments start with #

# This is a comment

String escape characters

Bun-flavored adds a few more escape sequences to TOML to work better with JavaScript strings.

# Bun-flavored TOML extras
\x{XX}     - ASCII           (U+00XX)
\u{x+}     - unicode         (U+0000000X) - (U+XXXXXXXX)
\v         - vertical tab

# Regular TOML
\b         - backspace       (U+0008)
\t         - tab             (U+0009)
\n         - linefeed        (U+000A)
\f         - form feed       (U+000C)
\r         - carriage return (U+000D)
\"         - quote           (U+0022)
\\         - backslash       (U+005C)
\uXXXX     - unicode         (U+XXXX)
\UXXXXXXXX - unicode         (U+XXXXXXXX)