Web Applications Stack Exchange is a question and answer site for power users of web applications. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

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?

share|improve this question

migrated from superuser.com May 10 '13 at 14:15

This question came from our site for computer enthusiasts and power users.

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.

share|improve this answer
This looks great! When I attempt to import though, it excludes .md files that I have on Google Drive so I can't select them. – Raine May 12 '13 at 0:35
There is actually a filter in the file picker based on the MIME type (text/x-markdown), not on the file title. That's not very convenient but it allows StackEdit to have its own files associated with it in Google Drive. You will need first to create the file in StackEdit and export it to Google Drive. – benweet May 12 '13 at 1:40
I just modified the filter from the Google Drive Picker in StackEdit so that you can import text/x-markdown, text/plain, application/octet-stream MIME types. That should solve your problem. – benweet May 14 '13 at 23:09
Yeah, definitely a great tool, I guess sometime in the near future it will hit hard in the Stack, and hopefully get a tag of its own here in Web Applications :). It already popped in the main Meta: meta.stackexchange.com/questions/202156/written-with-stackedit – brasofilo Oct 20 '13 at 21:53
@benweet I am really pleased to see the StackEdit and I do like it as an MarkupEditor. Still, there is something that will prevent me from going this way: it is missing the most important features of google docs: the ability to collaborate on the same document, several people editing at the same document, inline-comments, ....that's gold for reviewing. – sorin Nov 10 '13 at 12:33

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).

share|improve this answer
Yes, I could do this. Thanks! I'm going to poke around some more to see if there's something that already exists. – Raine May 12 '13 at 0:33
And that is what mangini/gdocs2md is - a script. See the answer by trepdatious. – nealmcb Oct 9 '14 at 23:51

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.

share|improve this answer

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.

share|improve this answer
Hi, I found and incorporated the edits in this fork amongst a bunch of others to a new repo with what I hope is some better user features (the handling of italic/bold etc was still really buggy, and not only batch saving to file but displaying markdown). Gonna leave my own answer, but please do take a look :-) – Louis Maddox Aug 18 '15 at 2:15

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).

enter image description here enter image description here

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.

share|improve this answer

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.

share|improve this answer

Also try Markdown Editor, that supports integration with Google Drive.

Disclaimer: I'm the developer of Markdown Editor.

share|improve this answer
Could you perhaps tell us our rights then? You've omitted any mention of licensing. – Carl Smith Mar 1 '14 at 11:04
Do you support math? – Drazick Apr 18 '14 at 0:52
Will you add equations? – Drazick Jul 27 '14 at 21:21
It is inappropriate to just link to your own page about your own software. That is indistinguishable from spam. Please describe your approach, how it is implemented, and whether it has any advantages over the other approaches described here. – nealmcb Oct 9 '14 at 23:29
I don't think this is spam, per se, but I agree that you should list the features of the product that fulfill the criteria of the actual question that was asked. – jonsca Oct 10 '14 at 10:12

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:

  1. Create your mark down wherever's convenient.
  2. When done export to the browser
  3. Copy the resulting text from the browser
  4. 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.

share|improve this answer

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.

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.