Metadata-Version: 2.4
Name: ihroteka-converter
Version: 1.2.4
Summary: A lightweight package for converting Markdown into Steam-compatible markup.
Project-URL: Homepage, https://github.com/pivoshenko/ihroteka-converter
Project-URL: Repository, https://github.com/pivoshenko/ihroteka-converter
Author-email: Volodymyr Pivoshenko <contact@pivoshenko.dev>
Maintainer-email: Volodymyr Pivoshenko <contact@pivoshenko.dev>
License-Expression: MIT
License-File: LICENSE
Keywords: bbcode,converter,formatter,gaming,ihroteka,markdown,markup,parser,steam,steam-bbcode,steam-bbcode-converter,steam-workshop,text-processing
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Ihroteka Converter

<p align="left">
  <a href="https://pypi.org/project/ihroteka-converter">
    <img alt="Python" src="https://img.shields.io/pypi/pyversions/ihroteka-converter?style=flat-square&logo=python&logoColor=white&color=4856CD&label=Python">
  </a>
  <a href="https://pypi.org/project/ihroteka-converter">
    <img alt="PyPI" src="https://img.shields.io/pypi/v/ihroteka-converter?style=flat-square&logo=pypi&logoColor=white&color=4856CD&label=PyPI">
  </a>
  <a href="https://github.com/pivoshenko/ihroteka-converter/actions/workflows/ci.yaml">
    <img alt="CI" src="https://img.shields.io/github/actions/workflow/status/pivoshenko/ihroteka-converter/ci.yaml?label=CI&style=flat-square&logo=githubactions&logoColor=white&color=0A6847">
  </a>
  <a href="https://docs.astral.sh/ruff">
    <img alt="Ruff" src="https://img.shields.io/badge/Style-ruff-black.svg?style=flat-square&logo=ruff&logoColor=white&color=D7FF64">
  </a>
  <a href="https://stand-with-ukraine.pp.ua">
    <img alt="StandWithUkraine" src="https://img.shields.io/badge/Support-Ukraine-FFC93C?style=flat-square&labelColor=07689F">
  </a>
</p>

## Overview

A lightweight package for converting Markdown into Steam-compatible markup.

**About the name**

*Ihroteka* (pronounced [ee-hroh-teh-kah]) is a Ukrainian word formed from "hra" (game) and "teka" (a place of keeping, an archive).
It evokes the image of a living library of games - a space where experiences are gathered, preserved, and given structure.

## Features

- Zero runtime dependencies
- Headings (`#`–`######`) → `[h1]`–`[h6]`
- Bold, italic, strikethrough, inline code
- Links and images → `[url]` / `[img]`
- Ordered and unordered lists (nested)
- Blockquotes (nested)
- Fenced and indented code blocks → `[code]`
- Horizontal rules → `[hr][/hr]`

## Installation

Proceed by installing the tool and running it:

```shell
pip install -U ihroteka-converter

uv add ihroteka-converter
```

## Usage

```python
from ihroteka_converter import convert

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 = convert(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.
```
