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 |