Update docs

Author: reakaleek

docs/syntax/headings.md

@@ -1,6 +1,6 @@
 # Headings
 
-You can have up to 6 levels of headings. But only levels 2 and 3 are displayed in table of contents sidebar.
+You create a heading by adding number signs `#` in front of a word or phrase. The number of number signs you use should correspond to the heading level. For example, to create a heading level three `<h3>`, use three number signs (e.g., `### My Header`).
 
 ## Basics
 
@@ -20,18 +20,6 @@ You can have up to 6 levels of headings. But only levels 2 and 3 are displayed i
 
 :::
 
-:::{tab-item} HTML
-
-```html
-<div class="heading-wrapper" id="heading-1">
-    <h1>
-        <a class="headerlink" href="#heading-1">Heading 1</a>
-    </h1>
-</div>
-```
-
-:::
-
 :::{tab-item} Output
 
 # Heading 1
@@ -61,48 +49,51 @@ You can have up to 6 levels of headings. But only levels 2 and 3 are displayed i
 
 ## Anchor Links
 
-By default, the anchor links are generated based on the heading text. You can also specify a custom anchor link using the following syntax:
+By default, the anchor links are generated based on the heading text.
+You will get a hyphened, lowercase, alphanumeric version of any string you please, with any [diacritics](https://en.wikipedia.org/wiki/Diacritic) removed, whitespace and dashes collapsed, and whitespace trimmed.
 
-### Default Anchor Link
+### Default Anchor Links
 
 ::::{tab-set}
 
 :::{tab-item} Markdown
 
 ```markdown
 
-## Hello-World
+#### Hello-World
 
 ```
 
 :::
 
 :::{tab-item} Output
 
-## Hello-World
+#### Hello-World
 
 :::
 
 ::::
 
 
-### Custom Anchor Link
+### Custom Anchor Links
+
+You can also specify a custom anchor link using the following syntax.
 
 ::::{tab-set}
 
 :::{tab-item} Markdown
 
 ```markdown
 
-## Heading [#custom-anchor]
+#### Heading [#custom-anchor]
 
 ```
 
 :::
 
 :::{tab-item} Output
 
-## Heading [#custom-anchor]
+#### Heading [#custom-anchor]
 
 :::