Markdown Hints

Markdown is used to make headings, bold, bulleted lists etc on the Rebel Toolkit pages.

This page contains tips for formatting your pages. Feel free to add things which you have found useful but were not obvious from the Markdown and BookStack documentation (see Editing Pages for the links to that documentation).

For even more documentation, and links to tools to make editing easier, we recommend The Markdown Guide or search online for Markdown.

Tables

In addition to classic Markdown, BookStack supports the Markdown Extra extensions, see https://michelf.ca/projects/php-markdown/extra/. This provides a number of extra facilities in addition to the original Markdown, in particular support for tables. Here is a quick example of how to insert a table.

| Item      | Value |
| --------- | -----:|
| Computer  | $1600 |
| Phone     |   $12 |
| Pipe      |    $1 |

This renders as:

Item Value
Computer $1600
Phone $12
Pipe $1

For example, this [![rebel ringers](/uploads/images/gallery/2020-08/thumbs-150-150/RebelRingers.png)](/books/engaging-our-rebels/page/rebel-ringing) renders as:

rebel ringers

Floating images to right or left

Rebel Ringers video The Markup Extra specification says that you should be able to add class attributes to image markup, but it doesn't work in BookStack. You need to put the image in as HTML as below if you want to float an image with the text wrapping round it. You can also use align-left and align-center.

<img src="/uploads/images/gallery/2020-08/thumbs-150-150/RebelRingers.png" alt="Rebel Ringers video" class="align-right">

Horizontal Rules in Dark Mode

Horizontal rules like this:


don't show up in BookStack Dark Mode. There is a link to turn Dark Mode on and off near the top of the sidebar or Info panel on the home page. This is a mistake in the BookStack default style sheet in Dark Mode where the horizontal rule is dark grey (#222) on a dark grey background. We mention it in case it puzzles you. We may or may not fix it.

Comments

You can add comments to be seen by subsequent editors of the page, but which will not appear on the final rendered page after the Markdown processing. There is no explicit mechanism for comments in Markdown, but we can make use of the reference-style link syntax like this:

[Comment]: # (you can put any message for editors here.
It can span more than one line)

Not to be confused with the BookStack comment facility, which is turned off.


Revision #5
Created Sun, Dec 13, 2020 11:10 AM by Charles Wicksteed
Updated Mon, Feb 13, 2023 12:09 PM by Ned Evans