txt2md-cli 0.1.0

Convert plain text files to Markdown with automatic heading, list and code detection

txt2md-cli

Convert plain text files to Markdown with automatic heading, list, and code detection — one command, no config.

---

The Problem

You have a .txt file full of notes, documentation, or exported content and want to quickly turn it into clean Markdown without manually adding #, -, or backticks everywhere. txt2md does this heuristically with zero configuration.

---

Installation

pip install txt2md-cli

Requires Python 3.8+. No external dependencies — only Python stdlib.

---

Usage

CLI

txt2md input.txt output.md

Python API

from txt2md_cli import convert_file, line_to_md

# Convert a full file
convert_file("notes.txt", "notes.md")

# Convert a single line
print(line_to_md("INTRODUCTION"))      # → # Introduction
print(line_to_md("- item one"))        # → - item one
print(line_to_md("some/path/file"))    # → `some/path/file`
print(line_to_md("Normal sentence."))  # → Normal sentence.

---

Detection Rules

Applied in order to each line:

Rule	Condition	Output
Heading	ALL-CAPS, ≤60 chars, no period	# Title Case
Bullet list	Starts with - or *	Preserved as-is
Numbered list	Starts with 1., 2., etc.	Preserved as-is
Inline code	>10 chars, <2 spaces	`text`
Paragraph	Everything else	Plain text

---

Example

Input (notes.txt):

INTRODUCTION

This is a normal paragraph with some text.

- First item
- Second item

1. Step one
2. Step two

/usr/local/bin/python3

CONCLUSION

Output (notes.md):

# Introduction

This is a normal paragraph with some text.

- First item
- Second item

1. Step one
2. Step two

`/usr/local/bin/python3`

# Conclusion

---

License

MIT © Santt997