Vim syntaxfile

Syntax for writing vim syntax-files.

Documentation

:h syn-match	https://vimhelp.org/syntax.txt.html#%3Asyn-match
:h syn-region	https://vimhelp.org/syntax.txt.html#%3Asyn-region
:h syn-arguments (ex. conceal, cchar, contained, ..)	https://vimhelp.org/syntax.txt.html#%3Asyn-arguments

Locations

${vim-or-plug}/syntax/${vim_filetype}.vim

syntax files

Example

ftdetect/my_language.vim

Register a filetype based on a file-extension

" ftdetect/my_language.vim

au BufRead,BufNewFile *.todo set filetype=todolist_simple

indent/my_language.vim

Define the indent settings for the filetype

" indent/my_language.vim

let b:did_indent = 1

setlocal autoindent
setlocal indentexpr=
setlocal tabstop=4
setlocal softtabstop=4
setlocal shiftwidth=4
setlocal expandtab

syntax/my_language.vim

Define the syntax-highligting for the filetype

" syntax/my_language.vim

" don't reload if already loaded
if exists('b:my_language_syntax')
    finish
endif

" Define marker colours (CLI/GUI)
let s:todo_colour     = 'magenta'
let s:gui_todo_colour = '#F57900'

" Define Regexes
let s:todo_regex = '\(^\s*\)\@<=\*\([a-zA-Z]\)\@!'

" Define syntax for Regexes
execute "syntax match my_language_todo  '". s:todo_regex ."'"

" Apply highlighting
execute ' highlight todolistsimple_todo ctermfg='. s:todo_colour .' guifg='. s:gui_todo_colour .' ctermbg=none cterm=bold gui=bold'

" mark file as loaded
let b:my_language_syntax = 1

Match Regions

syntax match
  \ MyCharacter
  \ /'.'/