gdocs-export

Export Google Docs to Markdown, HTML, and more

In this repository lives the gdexport command which will fetch Google Docs by URL and attempt to convert them to Markdown or just download them in the JSON representation that Google docs provides.

The formatting is not perfect yet and may not be for some time. This is still a beta work.

Installation

Installation requires a golang version 1.14 or greater currently. Many system packages will not work, so install Golang by hand if you need to.

OAuth2 Credentials

First, create a credentials.json per this example (click on "enable the Google Docs API" and follow the prompts).

If you do not do the import-credentials step below, the fetch command will not work.

The first time you launch the program to fetch a document, you will be prompted to visit something in your browser and insert a code to STDIN.

Installing the repository and setting it up

export GOBIN=$HOME/bin
go get -u github.com/erikh/gdocs-export/...
$GOBIN/gdexport import-credentials credentials.json

Usage

There are the following sub-commands:

• import-credentials: import a credentials.json downloaded from the google docs API. Needed to use the fetch command.
• fetch: Download a document and optionally convert it. go run ./cmd/gdexport help fetch for more information.
• convert: Convert a document on disk. go run ./cmd/gdexport help convert for more information.

Notes

• Consolas is the font used to make code blocks. Set the font in gdocs to consolas to enable them.
• Image tags are not ![](), they are <img> in markdown; this is legal and we can use dimensions safer this way.
• The markdown & html sanitizing code is not safe for automated use. Always validate the docs before you publish them.

Author

Erik Hollensbe github@hollensbe.org