Vim syntax highlighting for text/gemini files (*.gmi)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
tidux 67e4c29107 Add missing highlight mode for block quotes. Use Comment like vim-markdown does. 4 months ago
ftdetect Adds .gemini suffix 1 year ago
syntax Add missing highlight mode for block quotes. Use Comment like vim-markdown does. 4 months ago
LICENSE Adds license and readme 1 year ago
Makefile Limit headings to three and make mono blocks start at beginning of line, also fix makefile 1 year ago
README.md Adds .gemini suffix 1 year ago

README.md

Gemini Vim Syntax

This repo contains basic syntax highlighting for the Gemini protocol's text/gemini format.

How to install

git clone https://tildegit.org/sloum/gemini-vim-syntax
cd gemini-vim-syntax
make

That should get you up and running. Note that this installs the files for your user, not globally for the system. It should support Linux, Unix/BSD/Darwin, Windows, and Haiku out of the box.

What is supported

The current state of the syntax covers all items officially supported by the gemini spec:

  • Links get colored in three parts:
    • =>
    • URL
    • Link text
  • Headings
    • Up to three levels
    • Lines that start with one, two, or three # characters
  • List items
    • Lines that start with *
  • Preformatted text blocks
    • Handled as a range that starts and ends with ```

I plan to update the syntax when and if the spec adds more items to text/gemini.

Filetype

This syntax is set up to be used with files labled with the gmi or gemini extensions. For example:

$ vim my_gemini_map.gmi
# or
$ vim my_gemini_map.gemini

Surprises

It is possible that Windows users may find that the syntax does not work. I do not have a machine to test it on and would love some feedback. If it is not working it likely has to do with line endings. Windows uses <cairrage-return><<line-feed> and linux/unix use just <line-feed>. There are a number of ways to solve this problem ranging from just replacing the newlines manually to using software. In either case it shouldn't be too difficult.

License

All source files are provided under the unlicense.