Markdown Guide
Use Markdown syntax to add structure and style to your Notes in GCS. This page shows the most common formatting options with examples.
Markdown is also supported in the notes field in the Detail Editors for Traits, Skills, Spells, Equipment, and other advanced features.
| Element | Syntax | Output |
|---|---|---|
| Headings |
# Heading 1## Heading 2### Heading 3
|
(headings shown below) |
| Bold |
**bold** or __bold__
|
bold text |
| Italic |
*italic* or _italic_
|
italic text |
| Bold+Italic |
***text*** or ___text___
|
bold & italic text |
| Strikethrough | ~~text~~ |
|
| Quote | > quoted text |
> quoted text |
| Alerts |
> [!NOTE]> The alert text.
|
(alerts shown below) |
| Inline code | `code` |
inline code |
| Code block | ```code``` |
(block shown below) |
| Horizontal rule |
--- or ***
|
--- |
| Link | External: [text](https://example.com)Internal: [text](Markdown%20Guide]
|
text text |
| Markdown Link | [Markdown Guide](md:Markdown%20Guide) |
Markdown Guide |
| Page reference link | [Basic Set, page 45](B45) |
Basic Set, page 45 |
| Image |  |
 |
| List (unordered) |
- item- item
|
- test - test |
| List (ordered) |
1. item2. item
|
1. item 2. item |
| Table | See details below | (table shown below) |
| Escape Markdown | \**escape\** |
**escape** |
Headings create titles and organize your content. Use # symbols before the text. The more # you use, the smaller the heading.
# Heading 1
## Heading 2
### Heading 3
###### Heading 6 (smallest)
You can also create Heading 1 or Heading 2 with underlines:
Heading 1
=========
Heading 2
---------
Start a new paragraph by leaving a blank line between blocks of text.
This is one paragraph.
This is a second paragraph.
This is one paragraph.
This is a second paragraph.
End a line with two spaces or use <br> for a manual break.
First line (with two spaces)
Second line
First line<br>
Second line
First line (with two spaces)
Second line
First line
Second line
-
Italics: wrap text in one
*or_ -
Bold: wrap text in two
*or_ -
Bold & Italic: wrap text in three
*or_ -
Strikethrough: wrap text in two~
*Italic* or _Italic_
**Bold** or __Bold__
***Bold & Italic*** or ___Bold & Italic___
~~Strikethrough~~
Use > to mark quoted text. Add more > for nested quotes.
> a quoted line
> > a nested quote
a quoted line
a nested quote
Use alerts to emphasize critical information. Alerts are displayed with distinctive colors and icons to indicate the significance of the content.
> [!NOTE]
> Useful information the reader should know, even when skimming.
> [!TIP]
> Helpful advice for doing things better or more easily.
> [!IMPORTANT]
> Key information needed to achieve a goal.
> [!WARNING]
> Urgent info that needs immediate attention to avoid problems.
> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.
Note
Useful information the reader should know, even when skimming.
Tip
Helpful advice for doing things better or more easily.
Important
Key information needed to achieve a goal.
Warning
Urgent info that needs immediate attention to avoid problems.
Caution
Advises about risks or negative outcomes of certain actions.
- Inline code: wrap text in single backticks.
- Code block: wrap text in triple backticks.
This is `inline code`.
```
This is a code block with
its formatting preserved as typed.
```
This is inline code.
This is a code block with
its formatting preserved as typed.
Use three or more *, -, or _ on a line by themselves:
***
---
___
Plain links are auto-detected:
https://gurpscharactersheet.com
To add custom text, use [text](URL):
[Visit GCS](https://gurpscharactersheet.com)
You can also add tooltips if you hover over the link:
[Visit GCS](https://gurpscharactersheet.com "GURPS Character Sheet")
You can link to files in the same library using relative paths. This makes your notes easier to share because they don’t depend on absolute locations.
[Markdown Guide](./Markdown%20Guide)
Rules for relative paths:
- Use forward slashes
/(not Windows\). - Replace spaces with
%20. - The markdown extension (
.md) can be omitted in your links. -
./means “this folder.” -
../means “go up one folder.” -
../../means "go up two folders."
Important
If a file name or folder has spaces, always replace them with %20 in your link.
In addition to web links, GCS supports special link types:
Markdown file links (md:):
Use this to reference another Markdown file in your GCS library.
[Markdown Guide](md:Markdown%20Guide)
Markdown Guide
Page references (like B45):
Use this shorthand to link directly to a page in a GURPS book. See Page References for more details.
[Basic Set, page 45](B45)
Start with !, then use the same format as links:
You can also use relative paths for images (see links above):
Tip
Use relative paths for images stored in your library so they don’t break if you move the file.
Use -, *, or +:
- Barbarian
- Knight
- Mage
- Barbarian
- Knight
- Mage
Use numbers:
1. First
2. Second
3. Third
- First
- Second
- Third
You can start numbering anywhere, and GCS will auto-increment.
Indent items to nest them (and mix and match ordered and unordered lists):
1. First list item
- First nested list item
- Second nested list item
- More...
2. Another...
- First list item
- First nested list item
- Second nested list item
- More...
- First nested list item
- Another...
Use pipes | and hyphens - to make tables:
| First | Second |
|--------|----------|
| Line 1 | Column 2 |
| Line 2 | Column 2 |
| First | Second |
|---|---|
| Line 1 | Column 2 |
| Line 2 | Column 2 |
Use : for alignment in header rows:
| Left | Right | Center |
|:-----|------:|:------:|
| aa | bb | cc |
| Left | Right | Center |
|---|---|---|
| aa | bb | cc |
Note that tables don't have to have consistent column sizing:
| Left | Right | Centered |
|:---|---:|:---:|
| aa | bb | cc |
| aaaa | bbbb | cccc |
| Left | Right | Centered |
|---|---|---|
| aa | bb | cc |
| aaaa | bbbb | cccc |
Use a backslash \ before a character to prevent formatting.
These asterisks \*will not\* make the text bold.
These asterisks *will not* make the text bold.