Formatting content with Cloudpress
Cloudpress will convert the content of your Google Doc to the correct format required by your Content Management System. Typically this will be either HTML or markdown. In the case of WordPress, you have an option whether you want to use Gutenberg formatting, in which case Cloudpress will use the correct Gutenberg block.
The rest of this document will explain how the formatting in your Google Doc will be converted to HTML and markdown. The bottom line is that we will try and do the right thing.
Standard formatting
Normal text
Paragraphs using the Normal text style in Google Docs will be converted to normal text when exported.
HTML
Exported as a <p> element.
Gutenberg
Exported as a paragraph block.
Markdown
Exported as plain text.
Headings
Text using the various heading styles (Heading 1 through Heading 6) will be exported as the corresponding heading format.
HTML
Exported as <h1> through <h6> elements.
Gutenberg
Exported as a heading block of the corresponding level.
Markdown
Exported as # through ######.
Bold, italics and underline
Any bold, italic and underlined text will be exported as the corresponding style.
HTML
Exported as <strong>, <em> and <span style="text-decoration: underline;"> respectively.
Gutenberg
The corresponding text styling for bold, italic and underline will be applied.
Markdown
Bold text is surrounded by ** and italic text by _.
Underline is not supported when exporting to markdown.
Text alignment
Text alignment is not currently supported.
Images
Images included in your Google Doc will be uploaded to your Content Management System and the uploaded image will be referenced.
HTML
Exported as an img tag. If you specify a title and description for the image, it will be exported in the title and alt attributes of the image element. For example, an image with the title of “this is the title” and a description of “this is the description”, will be exported as <img src="/path/to/image.png" title="this is the title" alt="this is the description">.
Gutenberg
Exported as an image block.
Markdown
Exported using the markdown inline image style (![]()). If you specify a title and description for the image, they will also be exported. For example, an image with the title of “this is the title” and a description of “this is the description”, will be exported as .
Links
Any links will be converted to the corresponding link format for the target platform.
HTML
Exported as an <a> tag
Gutenberg
Exported as a link.
Markdown
Exported as an inline link ([]())
Tables
Tables inside a Google Doc will be exported as a table. The only exception is a single-cell table which can be converted to a code block (see below)
HTML
Exported as an <table> with <tr> and <td> elements
Gutenberg
Exported as a table block.
Markdown
Exported as an <table> with <tr> and <td> elements
Lists
Bulleted and numbered lists are exported to the corresponding list format.
HTML
Bulleted lists are exported as a <ul> element with child <li> elements. Numbered lists are exported as a <ol> element with child <li> elements.
Gutenberg
Bulleted lists are exported as an unordered lists block. Numbered lists are exported as an ordered list block.
Markdown
Bulleted lists are exported as lists with the bullet (*) list marker. Numbered lists are exported as lists with the numbered (1) list marker.
Drawings and charts
Exporting of drawing and charts are not currently supported.
Enhanced formatting
Inline code
To denote text as inline code, use either Courier or Courier New as the font for the text.
HTML
Text in Courier or Courier New font will be surrounded by a <code> element.
Gutenberg
Text in Courier or Courier New font will be marked as inline code.
Markdown
Text in Courier or Courier New font will be converted to code span - i.e. surrounded by a single backtick character (`)
Code blocks
To denote a block of source code, insert it in a single table cell (i.e. a table with a single row and single column).
HTML
Exported as a code block surrounded by <pre><code> elements
Gutenberg
Exported using the Gutenberg code block.
Markdown
Exported as a code block using code fences.
