Differences

This shows you the differences between two versions of the page.

--- doc:page_section_headings [2026/04/01 08:14] – [MediaWiki] Simon Grant
+++ doc:page_section_headings [2026/04/12 18:08] (current) – Simon Grant
@@ Line 5: / Line 5: @@
 When we talk about headings, we often use "h1" to mean a top-level heading, like a page title, because in HTML it is coded as `<h1>`. h2 is the next level down, etc.
-The text "Paragraphs and page section headings" above is a top-level, or h1 heading.
+The heading above – "Paragraphs and page section headings" – is a top-level, or h1 heading.
-The text "Using the editing menu" just following is an h2 heading.
+The heading  below – "Using the editing menu" – is an h2 heading.
 Paragraph breaks are created simply by leaving a completely blank line between paragraphs. This is true for all the lightweight markup languages that we mention here.
@@ Line 47: / Line 47: @@
 ----
+`# An h1 heading with one "#" sign`
 # An h1 heading with one "#" sign
+```
 Another h1 heading, made by putting '='s underneath
 ==================================================
+```
+Another h1 heading, made by putting '='s underneath
+==================================================
+`## An h2 heading with two "##" sign`
 ## An h2 heading with two "##" sign
+```
 And anther Markdown h2 with '-'s underneath
 -----------------------------------------
+```
+And anther Markdown h2 with '-'s underneath
+-----------------------------------------
+`### An h3 heading with three "###" signs`
 ### An h3 heading with three "###" signs
@@ Line 64: / Line 81: @@
 If you do use Markdown headings, be sure to leave a blank space after the one or more `#` characters.
-Unlike with Markdown in other places, you cannot use different text styles or links in DokuWiki, even with this plugin.
+Unlike with Markdown in other places, you cannot use different text styles or links in DokuWiki, even with this plugin, because of the way DokuWiki works.
 ----
@@ Line 72: / Line 89: @@
 MediaWiki markup looks like a mixture of DokuWiki and Markdown.
-Mediawiki `= heading 1 =` is the same as DokuWiki `====== heading 1 ======`; Mediawiki `== heading 2 ==` is DokuWiki `===== heading 2 =====`; Mediawiki `=== heading 3 ===` is DokuWiki `==== heading 3 ====`; etc. The DokuWiki rationale seems to be that a more important heading should be more visible, hence with more `=` signs; but the MediaWiki rationale is to match the number of `=` signs with the number of the heading level. As HTML has 6 levels of heading, MediaWiki follows up from 1 to 6 =; DokuWiki counts down from 6 to 1 =.
+Mediawiki `= heading 1 =` is the same as DokuWiki `====== heading 1 ======`; Mediawiki `== heading 2 ==` is DokuWiki `===== heading 2 =====`; Mediawiki `=== heading 3 ===` is DokuWiki `==== heading 3 ====`; etc. The DokuWiki rationale seems to be that a more important heading should be more visible, hence with more `=` signs; but the MediaWiki rationale is to match the number of `=` signs with the number of the heading level. As HTML has 6 levels of heading, MediaWiki follows up from 1 to 6 =; DokuWiki counts down from 6 to 1 =. See [[MediaWiki and DokuWiki]].
 ===== Table of contents =====
@@ Line 80: / Line 97: @@
 You can fold away the table of contents by clicking at the top of it.
-This means that you can link to a section in a page by appending `#` and then the modified section heading text. To give an example, the URL `https://www.dokuwiki.org/wiki:syntax#sectioning` takes you to [[doku>syntax#sectioning]] in the middle of DokuWiki's syntax page.
+This means that you can link to a section in any wiki page by appending `#` and then the modified section heading text. To give an example, the URL `https://www.dokuwiki.org/wiki:syntax#sectioning` takes you to [[doku>syntax#sectioning]] in the middle of DokuWiki's syntax page. These links to section headings work both for fully spelled out URLs and for short, internal links.