From 47614f416771aa0151909b7becd2b3ff4a8bfbb2 Mon Sep 17 00:00:00 2001
From: Kaushal Modi <kaushal.modi@gmail.com>
Date: Wed, 7 Mar 2018 15:17:35 -0500
Subject: [PATCH] Manually specifying heading anchors in Markdown content

Fixes https://github.com/gohugoio/hugoDocs/issues/393
---
 content/content-management/cross-references.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/content/content-management/cross-references.md b/content/content-management/cross-references.md
index a2c0de26e..c1103ffed 100644
--- a/content/content-management/cross-references.md
+++ b/content/content-management/cross-references.md
@@ -109,8 +109,22 @@ Ensuring heading uniqueness across the site is accomplished with a unique identi
 /content-management/cross-references/#hugo-heading-anchors:77cd9ea530577debf4ce0f28c8dca242
 ```
 
+### Manually Specifying Anchors
+
+For Markdown content files, if the `headerIds` [Blackfriday extension][bfext] is
+enabled (which it is by default), user can manually specify the anchor for any
+heading.
+
+Few examples:
+
+```
+## Alpha 101 {#alpha}
+
+## Version 1.0 {#version-1-dot-0}
+```
 
 [built-in Hugo shortcodes]: /content-management/shortcodes/#using-the-built-in-shortcodes
 [lists]: /templates/lists/
 [output formats]: /templates/output-formats/
 [shortcode]: /content-management/shortcodes/
+[bfext]: /formats/#blackfriday-extensions