Skip to main content

A package for converting markdown to HTML for chat Telegram bots

Project description

ChatGPT Markdown to Telegram HTML Parser

Overview

This project provides a solution for converting Markdown formatted text into HTML markup supported by the Telegram Bot API, specifically tailored for use in ChatGPT bots developed with the OpenAI API. It includes features for handling various Markdown elements and ensures proper tag closure, making it suitable for streaming mode applications.

Features

  • Converts Markdown syntax to Telegram-compatible HTML.
  • Supports inline code, bold, italic, underline, and strikethrough formatting.
  • Handles nested bold and italic formatting.
  • Converts Markdown links and lists to their HTML equivalents.
  • Processes code blocks with optional language specification, preserving formatting within <pre><code> tags.
  • Automatically appends missing closing delimiters for code blocks.
  • Escapes HTML special characters to prevent unwanted HTML rendering outside code blocks.

Usage

To use the Markdown to Telegram HTML Parser in your ChatGPT bot, integrate the provided Python functions into your bot's processing pipeline. Here is a brief overview of how to incorporate the parser:

  1. Ensure Closing Delimiters: Automatically appends missing closing delimiters for ` and ``` to ensure proper parsing.

  2. Extract and Convert Code Blocks: Extracts Markdown code blocks, converts them to HTML <pre><code> format, and replaces them with placeholders to prevent formatting within code blocks.

  3. Markdown to HTML Conversion: Applies various regex substitutions and custom logic to convert supported Markdown formatting to Telegram-compatible HTML tags.

  4. Reinsert Code Blocks: Reinserts the previously extracted and converted code blocks back into the main text, replacing placeholders with the appropriate HTML content.

Simply call the telegram_format(text: str) -> str function with your Markdown-formatted text as input to receive the converted HTML output ready for use with the Telegram Bot API.

Installation

You can install the package using pip:

pip install chatgpt-md-converter

Example

from chatgpt_md_converter import telegram_format

formatted_text = telegram_format("Here is some **bold**, __underline__, and `inline code`.\n```python\nprint('Hello, world!')\n```")
print(formatted_text)

Requirements

  • Python 3.x
  • No external libraries required (uses built-in re module for regex operations)

Contribution

Feel free to contribute to this project by submitting pull requests or opening issues for bugs, feature requests, or improvements.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chatgpt_md_converter-0.3.0.tar.gz (11.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chatgpt_md_converter-0.3.0-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

File details

Details for the file chatgpt_md_converter-0.3.0.tar.gz.

File metadata

  • Download URL: chatgpt_md_converter-0.3.0.tar.gz
  • Upload date:
  • Size: 11.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for chatgpt_md_converter-0.3.0.tar.gz
Algorithm Hash digest
SHA256 a356ea510feaa9382d1fdf693c07d8610c179fd77f4587a3b828568cb485c2d1
MD5 1e580a18ded57712486f027dfd9fe2f3
BLAKE2b-256 7a2cf420a9cdeffcb26aedbbf40f76f6189dca11b279b8dabf5ce5adfd985f91

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatgpt_md_converter-0.3.0.tar.gz:

Publisher: publish.yml on Latand/formatter-chatgpt-telegram

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chatgpt_md_converter-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for chatgpt_md_converter-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8ce51407bd4efa3278e591aed888d0efd0c930dba459e92a33ea8dafe990d111
MD5 4ff224969d036176419c675a71cccb02
BLAKE2b-256 61cb710d2ea87024f52dc7b2fb6b10995be2801ab5641f6cef434f18a109f998

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatgpt_md_converter-0.3.0-py3-none-any.whl:

Publisher: publish.yml on Latand/formatter-chatgpt-telegram

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page