AsciiDoc Syntax Highlighting and MacVim

Posted by Jen Tong on July 18, 2011

I’ve recently joined the world of AsciiDoc. I’m also the kind of developer who leverages every tool she can find. Since there is no IntelliJ plugin for AsciiDoc, it looks like I’ll have to settle for MacVim as my editor since it supports syntax highlighting of just about everything.

AsciiDoc is not a built in type for the MacVim syntax highlighter, and while AsciiDocs is nice enough to attempt to install the vim highlighting during setup, I still had to complete a few manual steps.

  1. Follow the installation instructions through.
  2. If it does not exist already, create a ~/.vim folder for your user specific vim settings.
$ mkdir -p ~/.vim
  1. Copy the provided vim configuration files in their entirety from the distribution to your ~/.vim folder
$ cp -r ~/tools/asciidoc-8.6.5/vim/* ~/.vim
  1. Fire up MacVim and test out the syntax highlighting by opening the AsciiDoc user manual. How meta is that? :) asciidoc

Ta da! Now get hacking! I mean docing!