@@ -515,8 +515,9 @@ command line option. The option takes an argument of the form `pattern:syntax` w
515515the absolute file path. The `syntax` part is the full name of a supported language
516516(use `bat --list-languages` for an overview).
517517
518−Note: You probably want to use this option as an entry in `bat`s configuration file instead
519−of passing it on the command line (see below).
518+Note: You probably want to use this option as [an entry in `bat`s configuration file](#configuration-file)
519+for persistence, instead of passing it on the command line as a one-off, as generally
520+you'd just use `-l` unless you are passing multiple filenames as arguments.
520521
521522Example: To use "INI" syntax highlighting for all files with a `.conf` file extension, use
522523```bash