note about heading levels

content/patterns/writing/markdown-and-metadata.md

@@ -18,6 +18,10 @@ title = "Menu button"
 +++
 ```
 
+{{% note %}}
+The title automatically becomes the page's main `<h1>` heading. The highest heading level you should use in the body of your markdown file is `<h2>`.
+{{% /note %}}
+
 ### Tags
 
 If you like, you can also tag the pattern so that it turns up in lists of similar content. You add tags in an array format. Note that all the TOML data is found at the top of the markdown file, between the `+++` lines.

docs/patterns/writing/markdown-and-metadata/index.html

@@ -437,6 +437,17 @@ title = "Menu button"
 +++
 </code></pre>
 
+<aside aria-label="note" class="note">
+  <div>
+    <svg aria-hidden="true" viewBox="0 0 41.667306 41.66729" focusable="false">
+      <use xlink:href="#info"></use>
+    </svg>
+    <p>The title automatically becomes the page&rsquo;s main <code>&lt;h1&gt;</code> heading. The highest heading level you should use in the body of your markdown file is <code>&lt;h2&gt;</code>.</p>
+
+  </div>
+</aside>
+
+
 <h3 id="tags">Tags</h3>
 
 <p>If you like, you can also tag the pattern so that it turns up in lists of similar content. You add tags in an array format. Note that all the TOML data is found at the top of the markdown file, between the <code>+++</code> lines.</p>

docs/print-version/index.html

@@ -800,6 +800,17 @@ title = "Menu button"
 +++
 </code></pre>
 
+<aside aria-label="note" class="note">
+  <div>
+    <svg aria-hidden="true" viewBox="0 0 41.667306 41.66729" focusable="false">
+      <use xlink:href="#info"></use>
+    </svg>
+    <p>The title automatically becomes the page&rsquo;s main <code>&lt;h1&gt;</code> heading. The highest heading level you should use in the body of your markdown file is <code>&lt;h2&gt;</code>.</p>
+
+  </div>
+</aside>
+
+
 <h3 id="tags">Tags</h3>
 
 <p>If you like, you can also tag the pattern so that it turns up in lists of similar content. You add tags in an array format. Note that all the TOML data is found at the top of the markdown file, between the <code>+++</code> lines.</p>