diff --git a/web_widget_x2many_2d_matrix/README.rst b/web_widget_x2many_2d_matrix/README.rst
index 9972ee0e0485..f49108245789 100644
--- a/web_widget_x2many_2d_matrix/README.rst
+++ b/web_widget_x2many_2d_matrix/README.rst
@@ -96,7 +96,7 @@ show_column_totals
     column totals. True by default
 
 Example
-=======
+~~~~~~~
 
 You need a data structure already filled with values. Let's assume we want to
 use this widget in a wizard that lets the user fill in planned hours for one
diff --git a/web_widget_x2many_2d_matrix/readme/USAGE.rst b/web_widget_x2many_2d_matrix/readme/USAGE.rst
index 8716546d49cb..514257d0065b 100644
--- a/web_widget_x2many_2d_matrix/readme/USAGE.rst
+++ b/web_widget_x2many_2d_matrix/readme/USAGE.rst
@@ -37,7 +37,7 @@ show_column_totals
     column totals. True by default
 
 Example
-=======
+~~~~~~~
 
 You need a data structure already filled with values. Let's assume we want to
 use this widget in a wizard that lets the user fill in planned hours for one
diff --git a/web_widget_x2many_2d_matrix/static/description/index.html b/web_widget_x2many_2d_matrix/static/description/index.html
index 8ee519c969bd..0b7103e3a309 100644
--- a/web_widget_x2many_2d_matrix/static/description/index.html
+++ b/web_widget_x2many_2d_matrix/static/description/index.html
@@ -404,8 +404,10 @@ <h1 class="title">2D matrix for x2many fields</h1>
 <p><strong>Table of contents</strong></p>
 <div class="contents local topic" id="contents">
 <ul class="simple">
-<li><a class="reference internal" href="#usage" id="id1">Usage</a></li>
+<li><a class="reference internal" href="#usage" id="id1">Usage</a><ul>
 <li><a class="reference internal" href="#example" id="id2">Example</a></li>
+</ul>
+</li>
 <li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li>
 <li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li>
 <li><a class="reference internal" href="#credits" id="id5">Credits</a><ul>
@@ -454,9 +456,8 @@ <h1><a class="toc-backref" href="#id1">Usage</a></h1>
 <dd>If field_value is a numeric field, it indicates if you want to calculate
 column totals. True by default</dd>
 </dl>
-</div>
 <div class="section" id="example">
-<h1><a class="toc-backref" href="#id2">Example</a></h1>
+<h2><a class="toc-backref" href="#id2">Example</a></h2>
 <p>You need a data structure already filled with values. Let’s assume we want to
 use this widget in a wizard that lets the user fill in planned hours for one
 task per project per user. In this case, we can use <tt class="docutils literal">project.task</tt> as our
@@ -506,6 +507,7 @@ <h1><a class="toc-backref" href="#id2">Example</a></h1>
 <span class="nt">&lt;/field&gt;</span>
 </pre>
 </div>
+</div>
 <div class="section" id="known-issues-roadmap">
 <h1><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h1>
 <ul class="simple">