Markdown test page¶
This page is a "sandbox", a mostly empty page to test things in the wiki.
It's a good page to modify in order to send fake commits on markdown
files to trigger the mdlint checks or other builds.
One would, for example, add or remove this line to trigger a build.
It also aims at demonstrating various Markdown features in use in the TPA wiki, to test conversions to other engines.
indented lists¶
"Normally" indented lists that Python-markdown shows as a flat list:
- item a
- item b
- subitem a
- subitem b
4-space indented lists that Python-markdown should render correctly:
- item a
- item b - subitem a - subitem b
Actual example: 2026-10-06 meeting page, metrics of the month.
Internal links¶
This is a GitLab-style "absolute" link that should be converted to a
relative link with a .md appended, by rewrite-links.py: service
list.
Mermaid diagrams¶
We have mermaid diagrams and they should render correctly, here's a simplified version of the GitLab architecture diagram.
graph TB
HTTP -- TCP 80,443 --> NGINX
Syntax highlighting¶
This is a Python block that should show up nicely:
def hello():
print("Hello world")
hello()
Actual example: object storage access policy.
GitLab shortcuts and wiki links¶
This works in GitLab, but is not really expected to work elsewhere:
- issue link: #40000
- issue link, with one project: #40000
- issue link, with two projects: tpa/team#40000
- issue link, with many projects: tpo/tpa/team#40000
- issue link, expanded with title: tpo/tpa/team#40000+
- wiki link: service
- plain URL: https://example.com
- etc
Note that three-layer links are broken with magiclink, see this bug report.
Redirections¶
GitLab has a .gitlab/redirects.yml file that we need to port.
For example, policy/0100-adr should go to policy/0100-adr-template
instead.
(And it seems like a link here doesn't actually work for some reason, but the redirections seem to work in mkdocs.)
Other basic markdown¶
Basic styles¶
This paragraph has bold, italics, bold and italics,
strikethrough, inline code. This is a separate line, but not a
separate paragraph.
Paragraphs¶
This line ends with two spaces.
So it has a line break with this line.
This is a separate paragraph.
Lists¶
Numbered list:
- one
- two 1. sub one 2. sub two
Bullet lists:
- item a
- item b
- sub a
- sub b
Task lists:
- foo
- bar
Block quotes¶
Blockquote
With an inline code block:
code blockNested quote... paragraph.
Tables¶
| Header 1 | Header 2 | Header 3 |
|---|---|---|
| Row 1 | Data | Data |
| Row 2 | Data | Data |
Horizontal rule¶
This is a line:
And this is after the line.