DR: Use an existing add on converter called Docs to Markdown - hackforla/website GitHub Wiki
This is a record in the Decision Records on Solutions Not Implemented.
Converting the guides in Google Docs to Markdown so that the Markdown can be used to display the guides on our website.
Using an add-on called Docs to Markdown to automatically convert from Google Docs to Markdown language.
This potential solution is not feasible because of the errors and bugs encountered.
Our team had been using an add-on called Docs to Markdown to automatically convert from Docs to MD but encountered bugs after the extension's latest update as detailed below.
- Docs to Markdown - Free, open-source Drive add-on that converts a Google Doc to simple, readable Markdown or HTML. (Available in Google Workspace Marketplace)
- Link to Extension: https://workspace.google.com/marketplace/app/docs_to_markdown/700168918607
- The next sections are also mentioned in this issue: https://github.com/hackforla/guides/issues/10#issuecomment-1066190743
As of January 8, 2022, the Docs to Markdown Converter released an update that removes error/warning messages called reckless mode.
However, a message as seen below still appears at the top of the converted MD file and there are more issues encountered (mentioned in the next section) after converting the document.
Images are not in the correct order
Expected Output
Actual Output
Backslashes appear randomly in the file
