All Syntax Features
This page should be an example for all the syntax features supported by An Otter Wiki. You display the markdown code via here.
or clickMarkdown paragraphs and text formatting
In markdown paragraphs are seperated by a blank line.
Without an empty line, a block of words will be rendered as paragraph.
Individuals words or sentences can be emphasized as monospace
, bold, italic or bold and italic. Or go wild and mark or strike out words.
An Otter Wiki stores all pages in UTF-8 in a git repository. With UTF-8 you get emojis like 🥳 and 🎆, that all modern browsers can display.
If you don't want to user a header for seperating parapgraphs, or a header is just not enough, add a horizontal line:
Links
Some example for links in the middle of a paragraph. A link to the otterwiki github project, folloed by an auto linked url to http://example.com, followed by a mail address mailto:mail@example.com. Commonly used are links inside the wiki, e.g. one pointing Home.
Footnotes
Here's a sentence with a footnote.1
Quotes
One quoted line.
Got more to quote?
You can highlight paragraphs as a quote.
The quote can span multiple lines!
And it can nest more quotes.
Markdown syntax will be rendered inside quotes.
List examples
Itemized lists look like
- this one
- with three
- items.
A numbered list
- first item
- second item
- third item
And a task list
- a unchecked item
- and bold checked item
The task list can only be mofied by editing it, not by clicking the checkboxes while viewing it.
Tables
A wide table with different aligend columns:
Very wide column without expliciit alignment | Left aligned column | Centered column | Rght aligned Column |
---|---|---|---|
Cell with Text | Cell with Text | Cell with Text | Cell with Text |
Cell with two lines. | Cell with Text | Cell with Text | Cell with Text |
A table with some formatting and an emoji.
Alpha | Bravo | Charlie |
---|---|---|
D elta | Echo | Foxtrott |
Golf | Hotel | India |
Juliett | Kilo | Lima |
November | Oscar | |
Papa | Quebec | Romeo |
Sierra | Tango | Uniform |
Victor | Whisky | X-Ray |
Yankee | Zulu | 🦦 |
Code blocks
Markdown is often used for documentation, so it's not a surprise that it should be excellent in displaying code and configurations. For example a minimal docker-compose.yaml
for running An Otter Wiki:
version: '3'
services:
otterwiki:
image: redimp/otterwiki:2.0
ports:
- 8080:80
This and many other examples for syntax highlighting can be found in Examples/Syntax Highlighting.
Lists can nest blocks
List can nest lists and other block.
For example
- an unordered list
- with two items
or
- an new level
- of an ordered list
- with three items.
Somtimes you might have to add
an entire paragraph to a list. To do that indent it with 4 spaces and add an empty line before and after the paragraph.
Maybe you want to add a fenced block of code
class Example: """Finding examples is hard.""" var = True
or a quote
You get the concept.
Math or LaTeX
If you want to share math formulas in your wiki, MathJax comes to the rescue. For example:
When \(a \ne 0\), there are two solutions to \(ax^2 + bx + c = 0\) and they are
\[x = {-b \pm \sqrt{b^2-4ac} \over 2a}.\]Special blocks
An Otter Wiki supports also some special blocks, whose syntax is derived from various dialects.
You can create spoiler blocks:
Not a massive spoiler, but useful to show that you can hide images and text inside a spoiler block.
Blocks with summary, that unfold the details on click:
Do you want to know more?
Detail blocks could be used for handling spoilers, too.
In case you have to highligh important informations, An Otter Wiki provides special blocks in different flavors.
An info block
with some content.and in the flavor of a
Warning block (in yellow)
With someformatting
in it.or a