HeroMarkdown

HERO System style specification for BaldarSilveraxe's (AKA Stephen S.) Roll20 markdown scripts. This example is modeled after Slugnet's excellent example for Alien RPG.

The Roll20 forum thread may be of interest.

Quickstart Using the HERO System CSS and Markdown in Roll20

Part 1 - Install the API Scripts on Roll20

You will need to either have an existing game on Roll20, or create a new game.

Install the three mods (aka API scripts) into your game:

• markdown.js (Updated with fixes for tables.)
• markdownNotesBio.js
• markdownDocumentation.js

For further documentation on installing mods, please visit the Roll20 Mod (API) help page.

Part 2 - Using the Markdown in a Roll20 Game

Once you have installed the API scripts, launch the game in Roll20. To prepare a handout for application of markdown code follow the steps below.

A. Getting Started

Create a new "Handout" named "Style Sheet". Scroll down to the "GM Notes" section and past the following two lines:

[css]
h1 {color: red;}

Save changes.

In the "Description & Notes" section you should see the processed CSS

[css](-O3fF3GCNgPDgG9m9-4L)
h1 {color: red;}

Like so:

Note

The "-O3fF3GCNgPDgG9m9-4L"` part is the object id for your handout. It will not be the same as you see in this example. That is the "link" for this style sheet. Copy the css line with code to the clipboard.

Create a new "Handout" named "Markdown Handout" and in the "GM Notes" paste the copied code. Add two additional lines of code like so:

[md]
[css](-O3fF3GCNgPDgG9m9-4L)
# This Heading should be red.

(You should paste in what you copied to the clipboard to the second line.)

Remember: The "-O3fF3GCNgPDgG9m9-4L"` part is the object id for your handout. It will not be the same as you see in this example.

Save changes.

In the "Description & Notes" section you should see the processed Markdown. It should be large red text reading:

This Heading should be red.

Like so:

B. Switching to HERO System Styling

If all has worked correctly in the previous steps, do the following.

Open the HERO-CSS-Markdown file. At the top of the page replace the object id below

[css](-O3fF3GCNgPDgG9m9-4L)

with your updated object id.

Now copy/paste everything in HERO-CSS-Markdown.css to the "GM Notes" section of the "Style Sheet" "Handout". Delete or overwrite the text that reads:

[css]
h1 {color: red;}

Save changes.

In the "Description & Notes" section you should see the processed CSS

[css](-O3fF3GCNgPDgG9m9-4L) <-- will not be this code, was replaced earlier.

bg {
	padding: 30px;
	padding-top: 1px;
	margin: -30px;
	max-width: 800px;
}

etc.

Now open the HERO Example Markdown file. At the top of the page find and replace the object id below

[css](-O3fF3GCNgPDgG9m9-4L)

with your updated object id.

Now copy/paste everything in HERO-Example.md to the "GM Notes" section of the "Handout" "Markdown Handout". Delete or overwrite the text that reads:

[md]
[css](-O3fF3GCNgPDgG9m9-4L)
# This Heading should be red.

Save changes.

In the "Description & Notes" section you should see the processed Markdown with its content like the image shown below.

Tip

Once you are comfortable setting up the Markdown script, you may skip most of Part A. For a new sheet begin with a new handout named "Style Sheet." Paste the contents of HERO-CSS-Markdown.css into the GM Notes section and save the handout. The script will generate the necessary hash, e.g., "css," which you may use in Part B.

Example Handout in Roll20

For reference, the original scripts can be found here:

• markdown.js
• markdownNotesBio.js
• markdownDocumentation.js