doc:page_section_headings

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
doc:page_section_headings [2026/04/01 08:16] – [Table of contents] Simon Grantdoc: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. 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. 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 # An h1 heading with one "#" sign
  
 +```
 Another h1 heading, made by putting '='s underneath 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 ## An h2 heading with two "##" sign
  
 +```
 And anther Markdown h2 with '-'s underneath 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 ### 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. 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 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 ===== ===== Table of contents =====
  • doc/page_section_headings.1775031410.txt.gz
  • Last modified: 2026/04/01 08:16
  • by Simon Grant