Folding and empty implicits highlighting can be disabled if needed for performance reasons.

Updated documentation.

Author: fmoralesc

doc/pandoc.txt

@@ -150,11 +150,27 @@ to autocomplete the citation.
 >     currently works with bibtex and MODS xml files, but the script
 >     doesn't look for MODS xml files)
 
+## Configuration
+
+Some global variables can modify the plugin's behaviour and performance:
+
+1. As mentioned before, soft or hard wrapping can be set with the
+   `g:pandoc_use_hard_wraps` variable set to 1.
+   If desired when using hard wrapping, vim-pandoc will activate
+   autoformatting is `g:pandoc_auto_format` is set to 1. Note that this can be
+   slow.
+
+2. Folding can be disabled by setting `g:pandoc_no_folding` to 1. This can
+   improve performance.
+
+3. Highlighting of empty implicit links can be expensive on large files. To
+   disable it, set `g:pandoc_no_empty_implicits` to 1.
+
 ## Dictionary-Based Citation Completions
 
 We are leaving this in for now, but now that proper autocompletion is
 working, we'll probably get rid of it. If you create a text file,
-
+`
     ~/.pandoc/citationkeys.dict
 
 that contains a list of citation keys, one per line, like so

ftplugin/pandoc.vim

@@ -57,8 +57,10 @@ setlocal comments=s:<!--,m:\ \ \ \ ,e:-->
 """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 " # Folding sections with ATX style headers.
 "
-setlocal foldexpr=MarkdownLevel()
-setlocal foldmethod=expr
+if !exists("g:pandoc_no_folding") || !g:pandoc_no_folding
+	setlocal foldexpr=MarkdownLevel()
+	setlocal foldmethod=expr
+endif
 
 """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 " # Use ctrl-X ctrl-K for dictionary completions.

plugin/pandoc.vim

@@ -219,8 +219,10 @@ endfunction
 " 
 " FM: I recommend `viewoptions` set to "folds,cursor" only. 
 "  
-autocmd BufWinLeave * if expand(&filetype) == "pandoc" | mkview | endif
-autocmd BufWinEnter * if expand(&filetype) == "pandoc" | loadview | endif
+if !exists("g:pandoc_no_folding") || !g:pandoc_no_folding
+	autocmd BufWinLeave * if expand(&filetype) == "pandoc" | mkview | endif
+	autocmd BufWinEnter * if expand(&filetype) == "pandoc" | loadview | endif
+endif
 
 """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 " 3. Completion

syntax/pandoc.vim

@@ -125,7 +125,9 @@ syn match pandocLinkURL /https\{0,1}:.\{-}\()\|\s\|\n\)\@=/ containedin=pandocLi
 syn match pandocAutomaticLink /<\(https\{0,1}.\{-}\|.\{-}@.\{-}\..\{-}\)>/
 syn match pandocLinkTextRef /\(\]\(\[\|(\)\)\@<=.\{-}\(\]\|)\)\@=/ containedin=pandocLinkText contained
 syn match pandocLinkTitle /".\{-}"/ contained containedin=pandocLinkArea contains=@Spell
-
+" This can be expensive on very lalrge files, so we should be able to disable
+" it:
+if !exists("g:pandoc_no_empty_implicits") || !g:pandoc_no_empty_implicits
 " will highlight implicit references only if, on reading the file, it can find
 " a matching reference label. This way, square parenthesis in a file won't be
 " highlighted unless they will be turned into links by pandoc.
@@ -149,7 +151,7 @@ for line in vim.current.buffer:
 regex = "\(" + r"\|".join(["\[" + label + "\]" for label in labels]) + "\)"
 vim.command("syn match pandocLinkArea /" + regex + r"[ \.,;\t\n-]\@=/")
 EOF
-
+endif
 """""""""""""""""""""""""""""""""""""""
 " Strong:
 "