ft_context - Vim Documentation

ft_context.txt        For Vim version 9.2.  Last change: 2026 Jan 10

This is the documentation for the ConTeXt filetype plugin.

NOTE: the plugin requires +vim9script.

==============================================================================
CONTENTS                                                context.vim ft-context

1. Introduction                         ft-context-intro
2. Commands                             ft-context-commands
3. Settings                             ft-context-settings
4. Mappings                             ft-context-mappings

==============================================================================
                                                        ft-context-intro
Introduction

ConTeXt, similarly to LaTeX, is a macro-based typesetting system built on TeX:


The ConTeXt plugin provides syntax highlighting, completion and support for
typesetting ConTeXt documents. The recommended way to typeset a document is to
use :ConTeXt, which invokes the mtxrun script that is found in $PATH.

For more fine grained control over the command and its environment,
context.Typeset() can be used directly (or context#Typeset() from legacy
Vim script). For instance, if a version of ConTeXt is installed in
~/context, you may define a function to use it similar to the following:





This code should go in ~/.vim/after/ftplugin/context.vim.

context.Typeset() accepts a third optional argument to specify a custom
typesetting command. That must be a function that takes a path and returns the
command as a list. For example:



Large projects are often organized as a root document and various chapter
files. When editing a chapter file, it is convenient to invoke :ConTeXt
directly on it, rather than having to switch to the root file. A "magic line"
can be added at the beginning of each chapter file, which specifies the
relative path to the root file. For instance:


Vim searches for the magic line in the first ten lines of the current buffer:
if it is found, the document specified by that line is typeset rather than the
one in the current buffer. The root document does not have to be opened in
Vim.

To extend completion and syntax highlighting, you may generate supporting
files using ConTeXt and add them to your configuration. If your configuration
resides in ~/.vim, you may use these commands:


The last command will create the following syntax files:

- context-data-context.vim;
- context-data-interfaces.vim;
- context-data-metafun.vim;
- context-data-tex.vim.

If present, such files will be automatically loaded to enhance syntax
highlighting. The same command can be used to update those syntax files.

                                                        ft-context-commands
Commands
                                        :ConTeXt
Start a background job to typeset the document in the current buffer. The
command accepts an optional buffer's name, if you want to typeset a document
that is in a different buffer.

                                        :ConTeXtLog
Edit the log file corresponding to the source in the current buffer.

                                        :ConTeXtJobsStatus
Echo the number of jobs currently running in the background.

                                        :ConTeXtStopJobs
Stop all the ConTeXt jobs currently running in the background.

                                                        ft-context-settings
Settings
                                        'b:context_ignore_makefile'
                                        'g:context_ignore_makefile'
:make can be used to (synchronously) typeset a document. If a Makefile exists
and this option is not set, standard make is used. If this option is set,
mtxrun is invoked instead, even if a Makefile exists.


NOTE: before using :make, ensure that the working directory of the buffer is
set to the directory of the file you want to typeset. Additionally, be aware
that :make searches for `mtxrun in $PATH.

                                        'g:context_extra_options'
A list of additional options to pass to mtxrun.


                                        'b:context_include'
                                        'g:context_include'
Dictionary of filetype/GROUP pairs for which syntax highlighting should be
activated between \startGROUP and \stopGROUP. The default is to highlight XML
between \startXML and \stopXML.


NOTE: Lua and MetaPost are always highlighted within the respective blocks.

                                        'g:no_context_maps'
When set, do not define any mappings.


                                                        ft-context-mappings
Mappings

tp                      "reflow TeX paragraph" (motion).

i$                      "inside inline math block" (text object selection).

a$                      "around inline math block" (text object selection).

]]                      [count] start of sections forward.

[[                      [count] start of sections backward.

][                      [count] end sections forward.

[]                      [count] end of sections backward.

]}                      [count] end of blocks (\stop..., \setup...,
                        \define...) forward.

[{                      [count] begin of blocks (\start..., \setup...,
                        \define...) backward.

 vim:tw=78:sw=4:ts=8:noet:ft=help:norl: