Cheatsheets:Markdown - Revision history

SeedBot: Standardize: add copy button to block code snippets

2026-08-23T09:45:55Z

Standardize: add copy button to block code snippets

Rongzhou at 08:04, 23 August 2026

2026-08-23T08:04:25Z

← Older revision		Revision as of 08:04, 23 August 2026
Line 1:		Line 1:
	{{Cheatsheet}}		{{Cheatsheet}}


			Markdown is plain text with a few magic markers that can be rendered into HTML-formatted text.

			New to Markdown? [https://commonmark.org/help/tutorial/ CommonMark interactive tutorial] may interest you.

	<blockquote>		<blockquote>
	~~Markdown is plain text with a few markers that a renderer turns into HTML.~~ This		This page is a syntax reference for '''CommonMark''', the standard. GitHub Flavored
	page is a syntax reference for '''CommonMark''', the standard. GitHub Flavored
	Markdown (GFM) extensions are covered in the [[#GFM extensions\|GFM extensions]]		Markdown (GFM) extensions are covered in the [[#GFM extensions\|GFM extensions]]
	section.		section.

	~~New to Markdown? [https://commonmark.org/help/tutorial/ CommonMark interactive tutorial] may interest you.~~
	</blockquote>		</blockquote>

Rongzhou: /* Blockquotes */

2026-08-19T16:22:34Z

Blockquotes

← Older revision		Revision as of 16:22, 19 August 2026
Line 350:		Line 350:
	== Blockquotes ==		== Blockquotes ==

	~~A line starting~~ with <syntaxhighlight lang="markdown" inline>></syntaxhighlight> is a blockquote~~; an empty~~ <syntaxhighlight lang="markdown" inline>></syntaxhighlight> ~~keeps paragraphs separate inside the quote.~~		Start with <syntaxhighlight lang="markdown" inline>></syntaxhighlight> for a blockquote.
			If you would like to include blank lines within the blockquote, type a line with a single<syntaxhighlight lang="markdown" inline>></syntaxhighlight>:

	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">

Rongzhou: /* Lists */

2026-08-19T16:20:34Z

Lists

← Older revision		Revision as of 16:20, 19 August 2026
Line 271:		Line 271:

	<blockquote>		<blockquote>
	'''A blank line between items ~~makes a loose list~~''' ~~— each item is wrapped in~~ a ~~paragraph~~:		'''Do not leave a blank line between items''': They will be rendered to give a loose feeling:

	{\| class="wikitable"		{\| class="wikitable"
	\|		\|
	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">
	- fruit		1. fruit
	- veg		1. veg
	</syntaxhighlight>		</syntaxhighlight>

	Rendered:		Rendered:
	<blockquote>		<blockquote>
	<ul>		<ol>
	<li>fruit</li>		<li>fruit</li>
	<li>veg</li>		<li>veg</li>
	</ul>		</ol>
	</blockquote>		</blockquote>
	\|\|		\|\|
	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">
	- fruit		1. fruit

	- veg		1. veg
	</syntaxhighlight>		</syntaxhighlight>

	Rendered:		Rendered:
	<blockquote>		<blockquote>
	<ul>		<ol>
	<li><p>fruit</p></li>		<li><p>fruit</p></li>
	<li><p>veg</p></li>		<li><p>veg</p></li>
	</ul>		</ol>
	</blockquote>		</blockquote>
	\|}		\|}

Rongzhou: /* Unordered */

2026-08-19T16:17:27Z

Unordered

← Older revision		Revision as of 16:17, 19 August 2026
Line 184:		Line 184:

	{\| class="wikitable"		{\| class="wikitable"
	~~! <syntaxhighlight lang="markdown" inline>-</syntaxhighlight> !! <syntaxhighlight lang="markdown" inline>*</syntaxhighlight> !! <syntaxhighlight lang="markdown" inline>+</syntaxhighlight>~~
	\|-
	\|		\|
	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">
Line 212:		Line 210:
	</blockquote>		</blockquote>

	~~Nest with an indentation~~:		For a nested list, indent:

	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">
Line 232:		Line 230:
	<li>veg</li>		<li>veg</li>
	</ul>		</ul>
			</blockquote>

			'''Note:'''

			<blockquote>
			Each indentation level can be either <code>\s\s</code> (2 spaces), <code>\s\s\s\s</code>(4 spaces), or <code>\t</code> (1 tab), depending
			on the configuration of your markdown renderer. In the majority of cases, 2 spaces work. Verify the docs of your markdown renderer.
	</blockquote>		</blockquote>

Rongzhou: /* Ordered */

2026-08-19T16:09:24Z

Ordered

← Older revision		Revision as of 16:09, 19 August 2026
Line 239:		Line 239:

	{\| class="wikitable"		{\| class="wikitable"
	~~! 3, 4 !! 3, 5 !! 3, 800~~
	\|-
	\|		\|
	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">
Line 271:		Line 269:

	{\| class="wikitable"		{\| class="wikitable"
	~~! Without (tight) !! With a blank line (loose)~~
	\|-
	\|		\|
	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">

SeedBot: Emphasis word-boundaries note as negative/positive table; Lists split into Unordered/Ordered subsections with marker and numbering equivalence tables (via update-page on MediaWiki MCP Server)

2026-08-19T16:06:50Z

Emphasis word-boundaries note as negative/positive table; Lists split into Unordered/Ordered subsections with marker and numbering equivalence tables (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 16:06, 19 August 2026
Line 143:		Line 143:

	<blockquote>		<blockquote>
	'''Emphasis needs word boundaries''' — underscores inside a word are literal, not emphasis.		'''Emphasis needs word boundaries''' — underscores inside a word are literal, not emphasis:

	Source <syntaxhighlight lang="markdown" ~~inline~~>foo_bar_baz</syntaxhighlight> ~~renders as~~ foo_bar_baz, ~~not as~~		{\| class="wikitable"
	~~"foo<i>bar</i>baz". Fix: use asterisks around whole words instead:~~		! Source !! Rendered
			\|-
	<syntaxhighlight lang="markdown">		\| <syntaxhighlight lang="markdown">foo_bar_baz</syntaxhighlight> \|\| foo_bar_baz (literal, no emphasis)
	foo bar baz		\|-
	</syntaxhighlight>		\| <syntaxhighlight lang="markdown">foo bar baz</syntaxhighlight> \|\| <em>foo bar</em> baz
			\|}
	</blockquote>		</blockquote>

Line 178:		Line 179:
	== Lists ==		== Lists ==

	Unordered markers <syntaxhighlight lang="markdown" inline>-</syntaxhighlight>, <syntaxhighlight lang="markdown" inline>*</syntaxhighlight> and <syntaxhighlight lang="markdown" inline>+</syntaxhighlight> are interchangeable~~. Ordered lists number from~~ the ~~first item's number~~, ~~whatever you write~~:		=== Unordered ===

			The markers <syntaxhighlight lang="markdown" inline>-</syntaxhighlight>, <syntaxhighlight lang="markdown" inline>*</syntaxhighlight> and <syntaxhighlight lang="markdown" inline>+</syntaxhighlight> are interchangeable — the same list, three ways:

			{\| class="wikitable"
			! <syntaxhighlight lang="markdown" inline>-</syntaxhighlight> !! <syntaxhighlight lang="markdown" inline>*</syntaxhighlight> !! <syntaxhighlight lang="markdown" inline>+</syntaxhighlight>
			\|-
			\|
	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">
	~~3. Mix the flour and milk.~~		- fruit
	~~4. Cook the batter in a pan.~~		- veg
			</syntaxhighlight>
			\|\|
			<syntaxhighlight lang="markdown">
			* fruit
			* veg
			</syntaxhighlight>
			\|\|
			<syntaxhighlight lang="markdown">
			+ fruit
			+ veg
	</syntaxhighlight>		</syntaxhighlight>
			\|}

	~~Rendered~~:		All three render identically:

	<blockquote>		<blockquote>
	<~~ol start="3"~~>		<ul>
	<li>~~Mix the flour and milk.~~</li>		<li>fruit</li>
	<li>~~Cook the batter in a pan.~~</li>		<li>veg</li>
	</ol>		</ul>
	</blockquote>		</blockquote>

	~~The numbering starts at 3, as typed — the first item's number sets the start.~~

	Nest with an indentation:		Nest with an indentation:
Line 216:		Line 232:
	<li>veg</li>		<li>veg</li>
	</ul>		</ul>
			</blockquote>

			=== Ordered ===

			Numbering starts from the first item's number, whatever you write afterwards:

			{\| class="wikitable"
			! 3, 4 !! 3, 5 !! 3, 800
			\|-
			\|
			<syntaxhighlight lang="markdown">
			3. Mix the flour and milk.
			4. Cook the batter in a pan.
			</syntaxhighlight>
			\|\|
			<syntaxhighlight lang="markdown">
			3. Mix the flour and milk.
			5. Cook the batter in a pan.
			</syntaxhighlight>
			\|\|
			<syntaxhighlight lang="markdown">
			3. Mix the flour and milk.
			800. Cook the batter in a pan.
			</syntaxhighlight>
			\|}

			All three render identically — the numbers after the first are ignored:

			<blockquote>
			<ol start="3">
			<li>Mix the flour and milk.</li>
			<li>Cook the batter in a pan.</li>
			</ol>
	</blockquote>		</blockquote>

Rongzhou: /* Escaping */

2026-08-19T16:04:06Z

Escaping

← Older revision		Revision as of 16:04, 19 August 2026
Line 390:		Line 390:
	\|}		\|}

	~~<blockquote>~~		Also, '''Markdown inside an HTML block is not parsed''' — raw HTML passes through untouched.
	'''Markdown inside an HTML block is not parsed''' — raw HTML passes through untouched.

	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">
Line 399:		Line 398:
	</syntaxhighlight>		</syntaxhighlight>

	renders the <syntaxhighlight lang="markdown" inline>bold?</syntaxhighlight> literally~~. Fix: don't wrap Markdown in raw HTML at all~~:		renders the <syntaxhighlight lang="markdown" inline>bold?</syntaxhighlight> literally:

	<syntaxhighlight lang="markdown">		<syntaxhighlight lang="markdown">
	bold? yes		bold? yes
	</syntaxhighlight>		</syntaxhighlight>
	~~</blockquote>~~

	== Further reading ==		== Further reading ==

Rongzhou: /* Code */

2026-08-19T16:02:23Z

Code

← Older revision		Revision as of 16:02, 19 August 2026
Line 281:		Line 281:

	<blockquote>		<blockquote>
	'''Legacy syntax:''' ~~indented code blocks.~~ Four leading spaces also produce a		'''Legacy syntax-indented code blocks:''' Four leading spaces also produce a
	code block, without highlighting:		code block, without highlighting:

Line 295:		Line 295:

	This form is '''not recommended''' — it is easy to break (a blank line ends		This form is '''not recommended''' — it is easy to break (a blank line ends
	it, and the indentation must change inside lists). ~~You~~ may still see it in		it, and the indentation must change inside lists). Since this used to be the standard for early versions of commonMark, you may still see it in older documents.
	older documents~~; use fenced blocks instead~~.
	</blockquote>		</blockquote>

Rongzhou: /* Links and images */

2026-08-19T15:55:55Z

Links and images

← Older revision		Revision as of 15:55, 19 August 2026
Line 163:		Line 163:
	\|}		\|}

	~~Alternative~~ to classic links like <syntaxhighlight lang="markdown" inline>[CommonMark](https://commonmark.org)</syntaxhighlight>, you can also use reference-style links, which allow you to refer to the target link with an arbitrary placeholder then declare the equivalence of the placeholder to your target link at the end of the file. This allows you to reuse a link in multiple places without repeating it.		Alternatively to classic links like <syntaxhighlight lang="markdown" inline>[CommonMark](https://commonmark.org)</syntaxhighlight>, you can also use reference-style links, which allow you to refer to the target link with an arbitrary placeholder then declare the equivalence of the placeholder to your target link at the end of the file. This allows you to reuse a link in multiple places without repeating it.

	{\| class="wikitable"		{\| class="wikitable"