Render Markdown / a Markdown-like language to Steam's markup format.
Visit the site, install @steamdown/cli, or use the
@steamdown/core library.
import { parse, render } from "@steamdown/core";
let src: string;
const [tree, context] = parse(src);
const markup = render(tree, context);This language should be familiar to anyone who has used Markdown, but there are some key differences. This section acts as a sort of "cheat sheet" for those who are already familiar with Markdown and just want to know what's different.
Some sites support this syntax, so it might be familiar to you, but it's not part of the original Markdown spec.
You can spoiler text by wrapping it in >! and !<.
>!This is a spoiler!<
[spoiler]This is a spoiler[/spoiler]
Steam has the [noparse] tag, which causes any text inside it to be rendered as plain
text. Steamdown supports this in both an inline and block form.
With noparse {[i]} will not be converted to italics.
Steamdown will also treat {*text inside noparse tags*} as plain text.
You can {{ {nest} }} inline noparse spans.
{{{
You can use noparse blocks for larger sections of text.
}}}
{{{{
{{{
You can nest noparse blocks.
}}}
}}}}
With noparse [noparse][i][/noparse] will not be converted to italics.
Steamdown will also treat [noparse]*text inside noparse tags*[/noparse] as plain text.
You can [noparse]{nest}[/noparse] inline noparse spans.
[noparse]
You can use noparse blocks for larger sections of text.
[/noparse]
[noparse]
{{{
You can nest noparse blocks.
}}}
[/noparse]
Some Markdown renders allow you to use >text (no space after the >) to create a
blockquote. To avoid conflicts with spoiler text, a space is required after the > in
Steamdown.
In Steamdown, quotes can also have an author, with an optional post ID, by adding
(author;post ID) after the quote. Quotes are not continued on newlines to avoid
syntax conflicts.
> quote without an author
> quote with an author
(author)
> quote with an author and post ID
(author;12345)
> quotes can continue
> on multiple lines
> quotes cannot
continue without another >
[quote]
quote without an author
[/quote]
[quote=author]
quote with an author
[/quote]
[quote=author;12345]
quote with an author and post ID
[/quote]
[quote]
quotes can continue
on multiple lines
[/quote]
[quote]
quotes cannot
[/quote]
continue without another >
Steam does not support cell alignment. It does, however, support equalcells=1 and
noborder=1, but apparently not for normal users. For noborder=1, use spaces instead
of - in the alignment row. For equalcells=1, use :---: in the alignment row, as
if you were centering a column in normal Markdown. "Alignment row" isn't really accurate
for Steamdown, though, so it should perhaps be called the "attribute row".
In the following examples, it should be noted that the "Attribute row" affects the entire table, not just a column. For this reason, the first cell in an attribute row takes precedence, and the following only need to be the same for clearer plain-text.
| one | two |
| --- | --- |
| a | b |
| one | two |
| | |
| a | b |
NOTE: Omitting the left and right | was considered as a better visual
representation of no borders, but was decided against because it could cause issues with
tables that are 1 cell wide.
| one | two |
| :-: | :-: |
| a | b |
| one | two |
| : : | : : |
| a | b |
Steam doesn't have an equivalent (the closest is [url=link]text[/url]), so images
are not supported. Consider using either links [alt text](url) or the plain-text link
instead.
Steam seems to render all [code] tags as blocks, so inline code is not supported.
Consider using a code block instead.