Help & Support
Send Feedback
Docs to Markdown
Drive add-on that converts a Google Doc to simple, readable Markdown or HTML.
7,872 users
Works with
# Docs to Markdown (GD2md-html): Googe Docs add-on

Docs to Markdown (GD2md-html) converts Google Docs to simple, readable Markdown or HTML.

This add-on allows you to create documents using the excellent editing and collaborative features of Google Docs, but publish as Markdown or HTML that you can store as text files using a version-control system. 

See for docs.

Release information (most recent on top):

- v1.0β17 (5 April, 2019): Convert smart quotes to straight quotes in code, but leave them alone in other text.
- v1.0β16 (25 Feb. 2019): Handle simple nested lists properly in HTML conversion (Markdown already works well).
- v1.0β15 (10 Feb. 2019): Number ordered list items sequentially (instead of using 1. for all items).No change to rendered HTML.
- v1.0β14 (15 Jan. 2019): Name change to Docs to Markdown: now published on G Suite Marketplace.
- v1.0β13 (29 Sept. 2018): Close strikethrough text properly at the end of a paragraph.
- v1.0β12 (24 Sept. 2018) : Convert strikethrough text.
- Revert to: // - 1.0β11: Fix small bug: replace bufout with bufHTML. Remove version number from banner. Retitle.
- v1.0β12 (28 May, 2018): Replace < with &lt; by default. Add option to allow HTML tags. Also allow escape (\<).
- v1.0β11 (24 March, 2018): No effect on output. Remove version number from banner. Retitle.
- v1.0β10 (17 Feb. 2018): Handle soft line-breaks (shift-enter) properly. (Markdown and HTML)
- v1.0β9 (9 Nov. 2017): Handle embedded paragraphs in list items for Markdown.
- v1.0β8 (30 Oct. 2017): Use _ instead of * for italic markup to avoid ambiguity (Markdown).
- v1.0β7 (10 Oct., 2017): Warn if DEBUG is true.
- v1.0β6 (07 Oct., 2017): Ignore headings that are blank or just contain whitespace.
- v1.0β5 (17 Sept., 2017): Warn about multiple H1 headings, but only in the top comment, not inline.
- v1.0β4 (16 Sept., 2017): Don't wrap HTML by default. Add checkbox option to wrap HTML. For footnotes also.
- v1.0β3 (29 July, 2017): Escape angle brackets (<) in HTML code blocks.
- v1.0β2 (15 July, 2017): Check for spurious 0-row table. Fix image path for placeholder links.
- v1.0β (10 July, 2017): Initial release of gd2md-html.
John Peterson
June 28, 2019
it works!
Submit reply
A User of Docs to Markdown
February 20, 2019
It does the job nicely and saves a lot of time. Would like the ability to turn off the alerts in the output but apart from that it saves me hours.
Submit reply
A user of Docs to Markdown
August 15, 2019
I find the alerts are large enough that when fixing them they actually become their own problem in the edit process. My ideal alert would be something like <!--- ******************* Picture goes here --->
A user of Docs to Markdown
February 28, 2019
I am glad this add-on saves you time -- thanks for taking the time to write a review. I am curious about why you want to turn off the alerts. By design, the alerts are intended to catch mistakes that would affect the reader experience (image links that need to be completed, drawings that cannot be converted, etc.).
A User of Docs to Markdown
January 8, 2019
This is really great. I know it is advertised as being a simple converter to html, but I was wondering if there would be any chance that a few additional things get converted from the google doc: such as font size and font color. Thanks for a great add-on!
Submit reply
A user of Docs to Markdown
January 10, 2019
Hi Harry -- thanks for the review -- I'm glad you like this add-on. While it is possible to convert some CSS-type things (sizes, foreground and background colors, etc.), I'm trying to convert content only, and leave CSS to the publishers. For the Google-internal version of this, I did experiment with font color and background. It worked (sort of), but there are many edge cases (like headings, colored code font) that are difficult to handle. And it adds some nasty HTML spans to handle the in-line CSS. So I'm inclined not to add this, but if/when I open-source this, you could have a go at it if you want to fork the code.
A User of Docs to Markdown
June 29, 2018
This is EXACTLY what I was looking for. A way to move (HTML) content over to Wordpress without having to ask my website editors to use a separate markdown editor. Removes all funky formatting, and works a treat. Thank you so much for your efforts!
Submit reply
A User of Docs to Markdown
May 8, 2018
Works sometimes, but the <li> tags were not closed.
Submit reply
A user of Docs to Markdown
September 12, 2018
They need to be closed if you have sub lists in lists... =\
A user of Docs to Markdown
July 16, 2018
Hi HiSuan, If there are times when it doesn't work properly for you, please file a bug: Thanks, - Ed
A user of Docs to Markdown
June 29, 2018
<li> tags don't need to be closed -
A User of Docs to Markdown
November 10, 2017
Invaluable tool in converting old HTML-based docs to Markdown. Workflow was to copy and paste from web page to Google Docs, make edits, and convert to MD for further editing before hosting on GitHub. Feature request: For simple tables, would like support for | GitHub | table | format | instead of HTML-based tables.
Submit reply
A user of Docs to Markdown
March 23, 2018
I too would like support for tables.
A user of Docs to Markdown
November 14, 2017
Thanks, Christopher. I'll investigate Markdown tables, but it may be hard to define (and determine) what a "simple" table is. This is a spare time project, but that would be a nice feature to have for simple documents.
1-6 of 6
Additional information
Clear search
Close search
Google apps
Main menu