What is gravitas-md2gdocs?

This is a small Python library that converts Markdown text into the format that Google Docs requires to update a document through its API. Google Docs does not accept plain Markdown, instead it expects a list of structured instructions describing what to insert, how to format it, and where to place it. Writing those instructions by hand is tedious, so this library does the translation automatically. You give the library a Markdown string and it returns the list of API requests. You then pass those requests to the Google Docs API using your own credentials. The library supports common Markdown features including headings at six levels, bold, italic, strikethrough, inline code, code blocks, links, bullet lists, numbered lists, and blockquotes. There is also an optional set of helper functions (installed with a separate extras flag) that add higher-level operations: appending content to the end of a document, replacing the entire contents, inserting text at a specific character position, or replacing a range of characters. These helpers handle the API call themselves, so they need a Google Docs service object passed in. The README notes that as of mid-2024 Google's Drive API can accept Markdown files directly when creating new documents, so this library is most useful when you need to update existing documents or insert content into a specific location rather than just creating a fresh document from scratch.