Marcal Tutorial

This page is designed to help you write your own Woebegone wiki pages using the Marcal syntax! Marcal is a modified version of Markdown (specifically based off Discord's implementation) designed to make the HTML much easier for you!

Blocks

Headers

Use the # symbol followed by a space for making headers. The more # you use, the smaller the header, up to six.

For example, this input:

# Title
## Subtitle
### Subsubtitle
#### Subsubsubtitle
##### Very small title
###### Smallest title

Returns this output:

Title

Subtitle

Subsubtitle

Subsubsubtitle

Very small title

Smallest title

Blockquotes

Use the > symbol at the start of lines to show they're block quotes.

> be me
> write tutorial

becomes

be me

write tutorial

Lists

Lists come in two flavors: unordered and ordered. Unordered lists are made with * or -:

* a thing
* another thing

- a thing
- another thing

becomes

a thing
another thing

a thing
another thing

Ordered lists are made with numbers followed by either . or ) and a space.

1. WOAH Bunch
420) No Name
69. FreeSmart

becomes

WOAH Bunch
No Name
FreeSmart

Code blocks

Anything between two lines of three ` will be rendered in a monospace font, and will ignore formatting.

 ```
 # code
 > code
 * code
 1. code
 ```

becomes

# code
> code
* code
1. code

Inline formatting

Italics, bold, underlines and strikethroughs

Italics are made surrounding a word with *, _ or ~:

*italics*
_italics_
~italics~

becomes

italics

italics

italics

Bold is made with two *, underline with two _ and strikethrough with two ~.

**bold**
__underline__
~~strikethrough~~

becomes

bold

underline

~~strikethrough~~

Code inlines

Text surrounded by two ` will be rendered in monospace. No example here because it is displayed in every description!

Embedded links

To insert a link, follow the [text](link) format.

[a *normal* YouTube video](https://youtu.be/dQw4w9WgXcQ)

becomes

a normal YouTube video

As demonstrated, formatting can be used inside of the link text!

Links within the wiki don't need the full URL, just the bit after the slash:

[a link to this very page](tutorial.html)

becomes

a link to this very page

Special Elements

All special elements use a [[Tag|detail=content|otherDetail=otherContent]] format. The tags are case sensitive and must come first.

Infoboxes

Infoboxes use the Info tag. They have three optional details:

There can be a title element, which is text to be rendered on top of the box;
There can be a link element, which should contain the url of an image for displaying;
If there's a link element, you should add an alt element, for the image's alt text;
Any additional elements are rendered below, with the left side bolded.

[[Info | title=Firey Plush | Species = Plush | Age =*at least 2* | Gender=Male]]

becomes

Firey Plush
Species	Plush
Age	at least 2
Gender	Male

Images

Images use the Image tag. They have one obligatory and five optional details:

There must be an link element, with the url of where the image is hosted;
There should be an alt element, for the alt text (a description of the image for screen readers or slow connections or broken links);
There can be a caption element, which renders (formattable) text under the image;
There can be a width and/or a height element, which sets the size of the image. It can be measured in percentage of the screen (60%), pixels (300px), or font size (1.5rem);
Lastly, there can be an align element, which can be left, none, or right. Text should wrap around the image, unless align is set to none.

[[Image | link=https://static.wikia.nocookie.net/nn-games/images/e/e5/7f483324496f2447b63e243e31ec27b1.jpg/revision/latest | caption=Moo, do not.|height=30% |align=right|alt=An image of Barry B. Benson.]] According to all known laws of aviation, there is no way a bee should be able to fly. Its wings are too small to get its fat little body off the ground. The bee, of course, flies anyway because bees don't care what humans think is impossible. Yellow, black. Yellow, black. Yellow, black. Yellow, black. Ooh, black and yellow! Let's shake it up a little.

becomes

Moo, do not.

According to all known laws of aviation, there is no way a bee should be able to fly. Its wings are too small to get its fat little body off the ground. The bee, of course, flies anyway because bees don't care what humans think is impossible. Yellow, black. Yellow, black. Yellow, black. Yellow, black. Ooh, black and yellow! Let's shake it up a little.

Uploading a page

To upload a page, you must send the .txt file to a wiki admin (currently just Calculovo, probably Tomorand too in the future), who will format it into HTML and add it to the wiki themself.

This technically makes this site barely a wiki anymore since there's a very hard filter on editing but it has the spirit of one.

End

Fun fact: did you know this page was written with Marcal?