diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6e8dcbd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,60 @@
+# print_md
+## A lightweight and simple CLI and library for colorful Markdown in the terminal
+
+`print_md` is a tiny tool that takes regular Markdown and renders it to the
+terminal using ANSI escape codes.  The output is styled with colours and
+typographic attributes (bold, underline, etc.) so that a Markdown file looks
+more pleasant when viewed directly from the console.
+
+The project ships two entry points:
+
+* **Command‑line** – a small script that reads files passed on the command
+  line and prints them to *stdout*.
+* **Python API** – the `render()` function can be imported from the
+  `print_md` package and used in any Python program.
+
+Both approaches use the same rendering logic and share the same colour
+configuration, so the output is identical no matter how you invoke it.
+
+---
+
+## Installation
+```bash
+pip install .   # Installs the package and the console script
+```
+
+---
+
+## Usage
+
+### As a command‑line tool
+```bash
+print_md intro.md how-to.md README.md
+```
+If you pass multiple files, each will be rendered sequentially:
+
+The script accepts a single positional argument – the path to a Markdown file
+or a glob pattern.  No additional flags are required.
+
+### Using the Python API
+```python
+from print_md import render
+
+sample = """
+# Title
+
+Hello, **world**!  This is a _test_.
+
+> A quote
+
+```python
+print('Hello')
+```
+"""
+
+print(render(sample))
+```
+
+The `render` function returns a string that contains the ANSI‑styled
+representation of the Markdown content.  You can pipe that string to any
+function that expects terminal output, such as `print()` or `sys.stdout.write`.