diff --git a/doc_src/block.txt b/doc_src/block.txt
index 5894f42d8..9fbbade83 100644
--- a/doc_src/block.txt
+++ b/doc_src/block.txt
@@ -41,6 +41,6 @@ block -e
 \endfish
 
 
-\subsection notes Notes
+\subsection block-notes Notes
 
 Note that events are only received from the current fish process as there is no way to send events from one fish process to another.
diff --git a/doc_src/emit.txt b/doc_src/emit.txt
index 2df1c9b8c..59a2c3b8e 100644
--- a/doc_src/emit.txt
+++ b/doc_src/emit.txt
@@ -22,7 +22,7 @@ end
 emit test_event something
 
 
-\subsection notes Notes
+\subsection emit-notes Notes
 
 Note that events are only sent to the current fish process as there is no way to send events from one fish process to another.
 \endfish
diff --git a/doc_src/fish_mode_prompt.txt b/doc_src/fish_mode_prompt.txt
index ee242369c..c397d2c33 100644
--- a/doc_src/fish_mode_prompt.txt
+++ b/doc_src/fish_mode_prompt.txt
@@ -9,7 +9,7 @@ The fish_mode_prompt function will output the mode indicator for use in vi-mode.
 The default `fish_mode_prompt` function will output indicators about the current Vi editor mode displayed to the left of the regular prompt. Define your own function to customize the appearance of the mode indicator. You can also define an empty `fish_mode_prompt` function to remove the Vi mode indicators. The `$fish_bind_mode variable` can be used to determine the current mode. It
 will be one of `default`, `insert`, `replace_one`, or `visual`.
 
-\subsection block-example Example
+\subsection fish_mode_prompt-example Example
 
 \fish
 function fish_mode_prompt
diff --git a/doc_src/function.txt b/doc_src/function.txt
index efaf12f5e..c441335fe 100644
--- a/doc_src/function.txt
+++ b/doc_src/function.txt
@@ -92,6 +92,6 @@ end
 This will beep when the most recent job completes.
 
 
-\subsection notes Notes
+\subsection function-notes Notes
 
 Note that events are only received from the current fish process as there is no way to send events from one fish process to another.