The source file for this page is pages/docs/markdown.md. There you can see the raw Markdown.

Styling content

Petridish uses kramdown as Markdown processor. This processor allows you to add attributes, such as CSS classes to your content (see this blog post). By sticking to Bootstrap classes, you can easily style your content. If that doesn’t fit your needs, you can always write html in your Markdown.

For example, the paragraph at the top of this page is styled as a Bootstrap alert because it has {:.alert .alert-warning} right before it. Block elements like paragraphs need their class on the line above it.

Inline elements on the other hand, need a class right after it. For example, to style a link as a button, use [Don't click](http://example.com){:.btn .btn-danger}:

Don’t click

Note that kramdown does not process bare URL like GitHub does (they need to be written as <url>). If you want your content to match the results you see on GitHub without the option to style, change the markdown parser in _config.yml to:

markdown: gfm # GitHub Flavoured Markdown

Headings

Heading h1

h1 headings are reserved for page titles and are hidden from content. Start your headings at h2.

Heading h2

Heading h3

Heading h4

Heading h5

Heading h6

Heading with custom id

Table of content

Add toc: true to your page/post front matter. See configuration.

Paragraphs

Set i won’t void spirit all. Had after called us It wherein Tree in deep abundantly also midst Seed. Beast. Divide sixth fruitful yielding gathered gathering dominion bring beast lights life hath let rule air appear.

Bring let rule creature. Very open hath to years. In second kind. Divide land night. Earth bearing tree lesser likeness likeness won’t. Likeness creature light.

Line breaks

This is the first line.
And this is the second line.

Emphasis

This is bold text

This is italicized text

This is bold italicized text

This is strikethrough text

Blockquotes

Gathering brought him green. Creeping very after hath a, from likeness dry tree moved dry fowl. Our let forth, male dry won’t god. Kind a thing, dominion lights midst him gathering waters fruitful greater god have dry land deep abundantly.

Lists

Unordered list:

• Item 1
• Item 2
• Item 3
  • Subitem 1
  • Subitem 2

Ordered list:

1. Item 1
2. Item 2
3. Item 3
   1. Subitem 1
   2. Subitem 2

Task list:

• Item 1
• Item 2
• Item 3

Definition list:

term 1

definition 1.1

definition 1.2

term 2

definition 2

Code

Inline code

Code block by indenting code with 4 spaces:

part_of_team = True
if part_of_team:
  print("Everything is awesome!") # If you're part of a team

Code block by fencing code in backticks. This method allows supports syntax highlighting by adding the language, e.g. ```python:

part_of_team = True
if part_of_team:
  print("Everything is awesome!") # If you're part of a team

Horizontal rules

Links

link with url

link with title

link with reference

url: http://www.example.com

See the Jekyll documentation to create internal links. There are several approaches, but in my opinion the safest option is using root-relative permalinks (starting with /) and the relative_url filter:

• For pages: [link text]({{ '/about/' | relative_url }})
• For posts: [link text]({{ '/permalink_of_post/' | relative_url }})
• For images and documents: [link text]({{ '/assets/images/name-of-image.jpg' | relative_url }})

You can simplify links if your site lives at a custom root domain (e.g. https://example.com, no baseurl set in _config.yml) or when Jekyll 4.0+ is used. Neither are the case for a default GitHub Pages, so the links below are likely broken:

• For pages: [link text](/about/)
• For posts: [link text](/permalink_of_post/)
• For images and documents: [link text](/assets/images/name-of-image.jpg)

If you want links that work on your site and in your GitHub repository, use relative links to the Markdown files (e.g. [about](../about.md)). These are automatically converted to permalinks by the jekyll-relative-links plugin (enabled by default on GitHub Pages), but will break if you move pages around.

Tables

Aligned columns:

HTML table with Bootstrap classes:

Petridish will automatically wrap tables in a div with class table-responsive to avoid tables getting wider than their parent container. It will also automatically convert <table> to <table class="table"> to enable Bootstrap layout, unless you already defined class(es) for your table.

Footnotes

Here’s a sentence with a footnote. ¹

Images

You can add an image caption by including an _emphasized sentence_ directly below the image without inserting a new line. This will wrap both image and caption in a paragraph.

See the the links section to learn how to reference your own images and documents.

By default, images will be centered horizontally and use the full width if they can. But you can change image alignment by using Bootstrap classes.

For example, the image below is wrapped in a paragraph with {:.col-md-8 .mx-auto} to contain it (and its caption) to 8/12 of the width on medium and larger screens. On small screens the full width will be used. Controlling the width of an image is especially useful for portrait images.

Image caption for this image should nicely wrap to the width of the container.

The image to the left is styled with {:.rounded .float-start} to give it round corners and position it at the start (i.e. left), with text wrapping around it. Note that in Bootstrap v5 .float-left was renamed to .float-start and .float-right to .float-end, but the old class names are still supported in Petridish.

The image does not wrap around this paragraph, because the previous paragraph also has a {:.clearfix} class, which contains wrapping to that paragraph only.