The ReadMe is pretty great now! https://github.com/microsoft/markitdown?tab=readme

There cli usage in readme now

There cli usage in readme now

I still don't see in the readme about using it via cli and the options for using it. Do you still need to update it?

Thank you

Maybe we should create and host docs?
The readme is getting way too long...

Maybe we should create and host docs?
The readme is getting way too long...

I would love to work on setting up the docs, please let me know the support you need on my end.

@jackgerrits do you have suggestions?

@gagb @jackgerrits

Please share your feedback on the proposed /docs folder structure. I plan to work on creating the documentation over the next week and submit a pull request after the New Year.

I will break down the existing README into smaller chunks, ensuring that the main README.md is simple to skim through, while redirecting users to the detailed docs as needed.

Wishing you and the team a Merry Christmas to those who are celebrating! :]

docs/
├── User Guide/              # For end users
│   ├── README.md            # Overview and quick start guide
│   ├── Installation.md      # Steps to install the tool
│   ├── Configuration.md     # Configuring the tool based on use case
│   ├── Usage.md             # Detailed usage instructions
│   ├── FAQ.md               # FAQ, Support and glossary
│
├── Contributor Guide/       # For developers and contributors
│   ├── Contributing.md      # How to contribute to the project
│   ├── Code_of_conduct.md   # Community behavior guidelines
│   ├── SECURITY.md          # Reporting security vulnerabilities
│   ├── LICENSE.md           # Licensing details
│   ├── Changelog.md         # History of changes and updates

You can easily set up a host for docs using GitHub Pages. Sphinx and MkDocs are perhaps the most popular options

Example

• AWS Copilot

Sounds good, let's discuss this with @afourney in new years when everyone is back! :)