Steamify

Overview

A lightweight package for converting Markdown into Steam-compatible markup, and back again.

About the Name

Steamify is what the package does: it takes Markdown and makes it Steam-flavoured, and it reads Steam markup back into Markdown. It was extracted from Ihroteka, a personal game-library app, and released standalone.

Features

Zero runtime dependencies, and conversion in both directions.

Markdown -> Steam

• Headings (# to ######) -> [h1] to [h3], since Steam caps at three levels
• Bold, italic, strikethrough, inline code
• Links and images -> [url] / [img]
• Ordered and unordered lists (nested)
• Blockquotes (nested)
• Fenced code blocks -> [code]
• Horizontal rules -> [hr][/hr]

Steam -> Markdown

• [h1] to [h6] -> # to ######
• [b], [i], [strike], [code] -> **, *, ~~, backticks
• [url] / [img] -> Markdown links and images
• [list] / [olist] (nested) -> - / 1.
• [quote] (nested) -> >
• [hr][/hr] -> ---
• Steam-only tags such as [spoiler], [noparse], [table], and [u] have no Markdown equivalent, so they pass through verbatim rather than being dropped

Round-tripping

to_steam(to_markdown(steam)) returns the original markup, so a Steam -> Markdown -> Steam cycle is stable. The Markdown side is normalized rather than preserved byte for byte:

• #### and deeper collapse into [h3] on the way out, and come back as ###
• Image alt text is not carried by [img], so it returns empty
• A single-line fenced block returns as an inline code span

Installation

Install with pip or uv:

pip install -U steamify

uv add steamify

Usage

from steamify import to_steam

md_text = """
# My Game Guide

Welcome to the **best** game ever!

## Features

- Easy to learn
- *Beautiful* graphics
- ~~Microtransactions~~ Free to play!

Check out the [wiki](https://example.com) for tips.
"""

steam_text = to_steam(md_text)
print(steam_text)

# [h1]My Game Guide[/h1]

# Welcome to the [b]best[/b] game ever!

# [h2]Features[/h2]

# [list]
# [*] Easy to learn
# [*] [i]Beautiful[/i] graphics
# [*] [strike]Microtransactions[/strike] Free to play!
# [/list]

# Check out the [url=https://example.com]wiki[/url] for tips.

Converting the other way:

from steamify import to_markdown

steam_text = """
[h1]Patch Notes[/h1]

[list]
[*] Fixed [b]crash[/b] on startup
[*] [spoiler]Secret boss[/spoiler] added
[/list]
"""

md_text = to_markdown(steam_text)
print(md_text)

# # Patch Notes

# - Fixed **crash** on startup
# - [spoiler]Secret boss[/spoiler] added