How can Google Docs and markdown play nice?

Question

I love Google Docs. I write notes, essays, correspondences, invoices, journal entries, business ideas, planning documents- everything on there.

I also love the markdown format. I'm a programmer so sometimes I'm in my editor and just want to write things in markdown instead of going to Google Docs.

However, when I save my markdown files in Google Drive, I can't preview them there, which is extremely disruptive to my workflow. Being able to preview markdown files in Google Drive would be a huge improvement.

Is there any way to enjoy the benefits of both Google Docs and markdown? Or are these writing platforms largely incompatible? Any elegant solutions I'm not thinking of?

score 158 · Answer 1 · edited Oct 23 '17 at 19:11

158

You can give StackEdit a try. It has a nice integration with Google Drive.

Once you import/export a Markdown document from/to Google Drive, you can open it later directly from Google Drive since StackEdit is integrated as a third party editor/viewer application.

You can find StackEdit as a Chrome application as well on the Web Store.

NOTE: I'm the developer of StackEdit.

edited Oct 23 '17 at 19:11

Fabian Schmengler

103
3

answered May 11 '13 at 13:52

benweet

2,119
1
12
10

score 23 · Answer 2 · edited Jun 16 '20 at 10:46

A Google Docs document encodes everything in 'elements' within the Kix editor that it's all based on (it's closed source as basically this is the big trade secret, with which anyone else could run their own Docs service - which is a shame imo).

You can access these elements with Google Apps Script, a variant of Javascript - but writing Markdown from the elements isn't as straightforward as you'd think (you have to essentially implement a markdown parser in Apps Script).

When I came to do this earlier in the year there were dozens of forks of Renato Mangini's "gdocs2md" repo, but he seemed to have stopped fielding pull requests, and over the period of a few years forks had appeared that were far better than others. I went through many of these in the tree and put the best into a new package, which also generates HTML mixed with the markdown for elements Google Docs supports such as superscript and subscript elements (which markdown has no way of representing). Even incorporating the best of others' edits, the parsing needed work, and I'm confident that this is the best available for the job at present.

Script available on GitHub with installation instructions: lmmx/gdocs2md-html

I also worked on adding in the most important feature to such a script - user features - providing the markdown in a pop-up within Google Docs rather than saving to file (I think the original was batch saving for entire folders, which is not suitable for my document-drafting needs, or how I use Google Docs at all).

I'd like to suggest it be a single more sophisticated project for interested developers to collaborate on (or at least suggest features for) rather than everyone forking off scripts of various quality, when we're likely working to the same aims.

As well as reducing duplication of effort, the Google Docs policy for creation of "add-ons" states that to be published (and therefore 'installable' rather than needing to be loaded for each document in a slightly awkward manner)

The add-on must be fully functional — it can't be a “work in progress.”

The script has been tested with multiple active users.

Obviously if you wanted a "pure" markdown then either switch off these features (the code is there to fork) or just don't use sub/superscripts, etc. It wouldn't be too difficult to add personalised settings to such a script if it matures as an add-on, if there's significant interest.

score 13 · Answer 3 · answered May 30 '13 at 21:10

You can convert a Markdown document to HTML, and copy/paste the HTML page (not the source) into a Google Drive document. It will retain most of the formatting including headings, lists, links, bold/italic/underline.

The font, margins, and font sizes will not match the Google Drive defaults, and will look "out of place" compared to standard Google Drive documents. Applying a custom CSS file to the HTML document will solve this, making the document look very similar.

I'm not sure about the other direction, converting Google Drive documents to Markdown. It may be possible to export to HTML and use an HTML to Markdown converter.

score 12 · Answer 4 · answered Jul 10 '14 at 10:55

gdocs2md does a good job of converting Google documents to markdown, retaining headers, lists, tables, italics, bold, links and images. I use it to allow shared editing of documents, then export to markdown.

Some care does need to be taken to use formatting in the Google document that maps well to markdown, but this isn't particularly difficult. I've also extended the script to support exporting an entire folder of documents to a new "export" folder on Google Drive, and to slightly improve handling of italic and bold formatting, my fork is here.

score 8 · Answer 5 · answered May 10 '13 at 15:07

You say you're a programmer, so this answer assumes you'd be comfortable with a little "roll your own" approach.

Google drive supports scripts: http://www.google.com/script/start/

So, you could create a little Showdown viewer that you point to your markdown files (as URLs).

jobukkit · Answer 6 · 2013-05-17T14:37:32.713

Download and install the Google Drive software. It's for Windows and Mac at the moment, a version for Linux is in the making. The software will create a folder on your computer that syncs with Google Drive. If you open a file in it, it will be opened in the appropriate installed program. Google Drive documents that you open will open in the browser.

This way, you can open/edit markdown files stored on Google Drive in an installed markdown editor.

undefined · Answer 7 · 2017-05-10T21:42:22.127

4

Preview Markdown Add-on for Google Docs gets my work done, it shows markdown preview in realtime in the sidebar with syntax highlighting.

I like to use Google Docs and I love the simplicity of markdown even more, that is why I put together showdown.js and highlight.js to create this small add-on.

edited May 10 '17 at 21:42

answered May 10 '17 at 18:52

undefined

141
3

score 4 · Answer 8 · answered Jan 14 '16 at 08:55

4

I recommend Markdown Preview Is a simple Add-on that (just) makes previews of the markdown document you are creating.

As far I understand, the main request is to preview it, so I think this is what you are searching for.

answered Jan 14 '16 at 08:55

eMarine

141
2

ijoseph · Answer 9 · 2020-11-22T19:48:58.820

3

One-way pandoc solution for Github-Flavored Markdown (GFM) .md with embedded MathJax-based LaTeX to Google Docs:

Offline, convert to .docx:

pandoc --from=markdown_github+tex_math_dollars --to docx test.md > test.docx

Then, merely upload to Google Drive. In Google Drive, right-click and choose Open with Google Docs.

edited Nov 22 '20 at 19:48

answered Jan 16 '19 at 01:38

ijoseph

141
6

score 0 · Answer 10 · answered Oct 23 '13 at 16:32

Assuming that once you're done making a document in markdown you want to convert it into a true google document (as opposed to being able to preview the document in the google drive web interface and continue editing in markdown syntax) so that others unfamiliar with markdown can collaborate I've found the following fairly quick:

Create your mark down wherever's convenient.
When done export to the browser
Copy the resulting text from the browser
Paste into a new Google Doc

Google docs is ready to have HTML pasted in so it'll preserve all the headings, spacing, lists, and other formats. Of course this only makes sense if you just want to personally work in markdown, but collaborate with others in a regular google doc.

score -1 · Answer 11 · answered Oct 24 '18 at 19:30

Strangely enough, Tumblr interconverts rich text, HTML, and markdown. I have had success in all directions, including taking markdown generated in Typora, pasting into a Tumblr post in md format, and then converting to rich text. Rich text can be pasted into Google Docs.

score -1 · Answer 12 · answered Jan 25 '20 at 21:25

Trello is another option for authoring files in Markdown. The Description field in the card can be formatted with Markdown. While perhaps not as "robust" as desired, if you are already using Trello or in a pinch it can work quite well.

I store some of my writing in Trello because:

I'm in Trello quite frequently already.
Web and mobile apps so it's available just about everywhere I am.
Real-time synchronization.

score -1 · Answer 13 · answered Jul 20 '20 at 09:58

-1

Easy solution using pandoc:

save your markdown file
convert it to html

pandoc -f markdown -t html5 mymarkdown.md > index.html

open html in browser, copy past to a google doc

answered Jul 20 '20 at 09:58

Jilles van Gurp

99

score -2 · Answer 14 · answered Jan 11 '20 at 10:37

-2

Hello INK for All has made our process around posting blog content to our static site so much faster with its integrated markdown export capability. The best part is It also exports Hugo compatible docs

answered Jan 11 '20 at 10:37

sandy

1

How can Google Docs and markdown play nice?

14 Answers14