diff --git a/docs/notes.rst b/docs/notes.rst
index 3bfc5304e..faed2c8fb 100644
--- a/docs/notes.rst
+++ b/docs/notes.rst
@@ -2,7 +2,7 @@ notes
 =====
 
 .. dfhack-tool::
-    :summary: Manage map-specific notes
+    :summary: Manage map-specific notes.
     :tags: fort interface map
 
 The `notes` tool enables players to annotate specific tiles
@@ -25,18 +25,18 @@ Usage
 Add new note in the current position of the keyboard cursor.
 
 Creating a Note
-~~~~~~~~~~~~~~~
+---------------
 1. Use the keyboard cursor to select the desired map tile where you want to place a note.
 2. Execute ``notes add`` via the DFHack console.
 3. In the pop-up dialog, fill in the note's title and detailed comment.
 4. Press :kbd:`Alt` + :kbd:`S` to create the note.
 
 Editing or Deleting a Note
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------
 - Click on the green pin representing the note directly on the map.
 - A dialog will appear, offering options to edit the title or comment, or to delete the note entirely.
 
 Managing Notes Visibility
-~~~~~~~~~~~~~~~~~~~~~~~~~
-- Access the ``DFHack Control Panel`` / ``UI Overlays`` tab.
+-------------------------
+- Access the `gui/control-panel` / ``UI Overlays`` tab.
 - Toggle the ``notes.map-notes`` overlay to show or hide the notes on the map.