Markdown template
Click "Edit" to see how all of the things here are written
Note: every preview is placed in admonitions
Basic syntax¶
Extended syntax¶
Quick rundown through syntax available with extensions, which can be explained quickly
Nesting elements¶
uses extension: pymdownx.superfcences
Converting special symbols¶
uses extensions: smarty, pymdownx.smartsymbols
These are the symbols that get replaced:
™ © ®
℅ ± ≠
→ ← ↔
½ ¼ ⅝
1st 2nd 3rd 4th
« »
…
– —
GitHub links¶
uses extension: pymdownx.magiclink
User mention: @halatnikov
Repository link: halatnikov/linum-framework
Links for Linum:
Issue: #1
Pull request: !1
Discussion: ?1
Commit: 7dbdb07
Diff/Compare: 3fdc4e6...d2e1bec
Links for other repositories:
Issue: STJr/SRB2#206
Pull request: alemart/opensurge!49
Discussion: ppy/osu?13096
Commit: STJr/Kart-Public@7ab1c4a
Diff/Compare: mmatyas/supermariowar@57b639c...3917df2
Converting of existing links:
Also supports Twitter mentions: @holatnikov
A few custom links:
Marking¶
uses extension: pymdownx.mark
This is a marked text
A word can be highlighted too
Inserting (underscoring)¶
uses extension: pymdownx.caret
This is an inserted text
A word can be underscored too
Deleting (strike-through)¶
uses extension: pymdownx.tilde
This is a deleted text
A word can be striked-through too
Emoji and icons¶
Full list can be found here
uses extension: pymdownx.emoji
Emoji:
Icon (replace all / with -):
Buttons¶
Just a regular link but with an attribute attached
uses extension: attr_list
Keyboard keys¶
A full list can be found here
uses extension: pymdownx.keys
Ctrl+Alt+Del
Z
Alt+F4
Up+Up+Down+Down+Left+Right+Left+Right+B+A+Enter
Progress bars¶
Colored according to their progress
uses extensions: pymdownx.progressbar, attr_list
Regular:
Striped:
Thin:
Superscript¶
Small symbols facing up
uses extension: pymdownx.caret
H20
This is a superscript
Subscript¶
Small symbols facing down
uses extension: pymdownx.tilde
CH3CH2OH
This is a subscript
Footnotes¶
Usually these are at the bottom of page, but for now they're here
uses extension: footnotes
Highlighting changes¶
This has a somewhat limited use scope
uses extension: pymdownx.critic
You can make striked-through text red and underscored text green
And also make comments inline
You can do blocks too!
Tabs¶
uses extension: pymdownx.tabbed
Abbreviations¶
Only plain text is supported
uses extension: abbr
Regular¶
This can technically be any word whatsoever
With a dictionary¶
See bottom of this file in editor
uses extension: pymdownx.snippets
The INI files that Linum uses are actually converted to JSON in-engine
Admonitions¶
Also known as call-outs
uses extension: admonition
Regular blocks¶
This is a title
This is a text
Look, there's no title
Collapsible blocks¶
uses extension: pymdownx.details
Closed
This is a closed collapsible block
Open
This is an open collapsible block
Types of blocks¶
Click to open
Built-in:
Note
Summary
abstract
, tldr
Info
todo
Hint
tip
, important
Success
check
, done
Help
question
, faq
Warning
caution
, attention
Fail
missing
Danger
error
Bug
Example
Quote
Code blocks¶
Regular¶
Syntax highlighting¶
uses extensions: pymdownx.highlight, pymdownx.inlinehilite
Adding a title¶
uses extension: pymdownx.highlight
Code annotations¶
uses feature flag: content.code.annotate
- this a code annotation, it can be placed anywhere where a comment can be placed in that language
Line numbers¶
uses extension: pymdownx.highlight
can start from any line:
you can also mark them:
Embedding external files¶
uses extension: pymdownx.snippets
Tables¶
uses extension: tables
Regular¶
this | is a | table |
---|---|---|
left-aligned | middle-aligned | right-aligned |
1 | 2 | 3 |
Sorted table¶
Every table can also be sorted by clicking on headers
uses javascript: tablesort
Number | Alphabetical | Version | Date |
---|---|---|---|
0 | C | 0.1.0 | 01/Jan/2022 |
1 | B | 0.7.8 | 10/Feb/2022 |
2 | A | 0.2.3 | 20-Mar-2022 |
5 | M | 0.1.1 | 30-Apr-2023 |
10 | Z | 1.0.0 | 02/Dec/2022 |