Merge branch 'main' into patch-2

README.md

@@ -15,6 +15,21 @@ It presently supports:
 - HTML (special handling of Wikipedia, etc.)
 - Various other text-based formats (csv, json, xml, etc.)
 
+# Installation
+
+You can install `markitdown` using pip:
+
+```python
+pip install markitdown
+```
+
+or from the source
+
+```sh
+pip install -e .
+```
+
+# Usage
 The API is simple:
 
 ```python
@@ -30,15 +45,32 @@ To use this as a command-line utility, install it and then run it like this:
 ```bash
 markitdown path-to-file.pdf
 ```
+
 This will output Markdown to standard output. You can save it like this:
+
 ```bash
 markitdown path-to-file.pdf > document.md
 ```
+
 You can pipe content to standard input by omitting the argument:
+
 ```bash
 cat path-to-file.pdf | markitdown
 ```
 
+
+You can also configure markitdown to use Large Language Models to describe images. To do so you must provide mlm_client and mlm_model parameters to MarkItDown object, according to your specific client.
+
+```python
+from markitdown import MarkItDown
+from openai import OpenAI
+
+client = OpenAI()
+md = MarkItDown(mlm_client=client, mlm_model="gpt-4o")
+result = md.convert("example.jpg")
+print(result.text_content)
+```
+
 ## Contributing
 
 This project welcomes contributions and suggestions.  Most contributions require you to agree to a
@@ -53,6 +85,23 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
 
+### Running Tests
+
+To run the tests for this project, use the following command:
+
+```sh
+hatch shell
+hatch test
+```
+
+### Running Pre-commit Checks
+
+If there are pre-commit hooks configured (indicated by the `.pre-commit-config.yaml`), you can test them by running:
+
+```sh
+pre-commit run --all-files
+```
+
 ## Trademarks
 
 This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft