I changed the way I create links to use references to a data YML file instead of relying on the capture tag and including reference to the file with the captions. Using the capture tag was highly susceptible to broken links and way too manual. See the Links topic for more detail about the new method.

doc_syntax_highlighting.md

@@ -5,7 +5,7 @@ keywords: rouge, pygments, prettify, color coding,
 last_updated: August 12, 2015
 summary: "You can apply syntax highlighting to your code. This theme uses pygments and applies color coding based on the lexer you specify."
 ---
-{% include linkrefs.html %} 
+
 
 ## About syntax highlighting
 For syntax highlighting, use fenced code blocks optionally followed by the language syntax you want:
@@ -63,6 +63,7 @@ The keywords you must add to specify the highlighting (in the previous example,
 
 * js
 * html
+* yaml
 * css
 * json
 * php