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 be exported as well.

For example, an image with the title of “this is the title” and a description of “this is the description”, will be exported as ![this is the description](/path/to/image.png “this is the title”).

Any links to 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

A tables inside a Google Doc will be exported as table. The only exception is a single-cell table which will 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.