text2markdown-formatter

text2markdown-formatter is a lightweight Python package that converts unstructured raw text into clean, well‑structured Markdown documents. By leveraging the llmatch-messages utility and a default ChatLLM7 model, the package ensures the output follows a consistent Markdown format, making it ideal for bloggers, writers, developers, and anyone who works with Markdown for documentation or content creation.

Features

• Automatic transformation of notes, ideas, or drafts into polished Markdown.
• Built‑in support for the ChatLLM7 model (no extra configuration required).
• Ability to plug in any LangChain‑compatible LLM (OpenAI, Anthropic, Google Gemini, etc.).
• Simple, single‑function API.

Installation

pip install text2markdown_formatter

Quick Start

from text2markdown_formatter import text2markdown_formatter

raw_text = """
My project ideas:
- Build a web scraper.
- Write a blog post about AI.
- Create a small game.
"""

markdown = text2markdown_formatter(user_input=raw_text)
print("\n".join(markdown))

API Reference

text2markdown_formatter(user_input: str, api_key: Optional[str] = None, llm: Optional[BaseChatModel] = None) -> List[str]

The function returns a list of Markdown strings extracted from the LLM response.

Using a Custom LLM

You can replace the default ChatLLM7 with any LangChain chat model.

OpenAI

from langchain_openai import ChatOpenAI
from text2markdown_formatter import text2markdown_formatter

my_llm = ChatOpenAI()
markdown = text2markdown_formatter(user_input="My notes...", llm=my_llm)

Anthropic

from langchain_anthropic import ChatAnthropic
from text2markdown_formatter import text2markdown_formatter

my_llm = ChatAnthropic()
markdown = text2markdown_formatter(user_input="My notes...", llm=my_llm)

Google Gemini

from langchain_google_genai import ChatGoogleGenerativeAI
from text2markdown_formatter import text2markdown_formatter

my_llm = ChatGoogleGenerativeAI()
markdown = text2markdown_formatter(user_input="My notes...", llm=my_llm)

Environment Variables

• LLM7_API_KEY – Your API key for the LLM7 service. Obtain a free key by registering at https://token.llm7.io/.

If you don’t set this variable, the package will fall back to the free tier limits of LLM7.

Rate Limits

The free tier of LLM7 provides sufficient quota for typical usage of this package. If you need higher limits, supply your own API key via api_key argument or the LLM7_API_KEY environment variable.

Contributing & Support

• Issues: https://github.com/chigwell/text2markdown-formatter/issues
• Pull Requests: Contributions are welcome! Please follow the standard GitHub workflow.

Author

Eugene Evstafev – hi@euegne.plus
GitHub: chigwell

Enjoy turning raw text into beautiful Markdown with text2markdown-formatter!