Metadata-Version: 2.4
Name: kindle-to-markdown
Version: 0.1.0
Summary: A simple program to convert Kindle HTML annotations to a Markdown file.
Keywords: kindle,markdown,converter,python
Author: Basti Tee
Author-email: Basti Tee <basti.tee@icloud.com>
License-Expression: Apache-2.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: click>=8.1.7
Requires-Dist: beautifulsoup4>=4.12.3
Maintainer: Basti Tee
Maintainer-email: Basti Tee <basti.tee@icloud.com>
Requires-Python: >=3.10, <3.14
Project-URL: Homepage, https://github.com/BastiTee/kindle-to-markdown
Project-URL: Repository, https://github.com/BastiTee/kindle-to-markdown
Description-Content-Type: text/markdown

# Kindle Annotations to Markdown

> A simple program to convert Kindle HTML annotations to a Markdown file

## Features

-   Conversion of page bookmarks, text highlights, and notes to Markdown
-   Included reference positions of annotations
-   Automatic detection of annotation file's language ([currently supported](kindle_to_markdown/languages.py))

## Usage

```shell
$ kindle_to_markdown --help
Usage: kindle_to_markdown [OPTIONS]

  A simple program to convert Kindle HTML annotations to a Markdown file.

Options:
  -i, --input-file PATH   Path to the Kindle annotations HTML file.
                          [required]
  -o, --output-file PATH  Path to the Markdown file.
  -p, --print-only        Only print Markdown to the console.
  --help                  Show this message and exit.
```

## Installation

### From PyPi

```shell
pip install kindle-to-markdown
```

### From Source

Prerequisites:

-   `python` in a [supported version](pyproject.toml) available on your path.
-   Package manager `uv` installed (see [uv installation](https://docs.astral.sh/uv/getting-started/installation/))

```shell
make
uv run python -m kindle_to_markdown --help
```
