Skip to main content
All CollectionsConvert
Create and format text
Create and format text
Maximilian Hoppe avatar
Written by Maximilian Hoppe
Updated over a week ago

We use the Textile markup language for many text elements. Compared to direct formatting via HTML, this has the advantage that errors within the page structure cannot occur because, for example, a closing HTML tag was forgotten.

In order to make the available formatting easier to use, the corresponding input fields are equipped with this menu:

Of course, you can also enter the formatting directly without using the menu. Please note that with block formatting it is necessary to insert a blank line after the relevant paragraph so that the textile parser can clearly determine the end of the formatting.

headlines

The headings are written in Textile via h. excellent. n indicates the level of the heading. So would h2. create a second degree heading. This is a block formatting that affects all contiguous lines. The menu bar shows the headings of the first to third degree.

Body text formatting

Within a text block, you can format individual words or text passages differently:

  • To emphasize words, use enclose them with an asterisk (asterix)Example: Text with *emphasis* becomes: Text with emphasis

  • To italicize words, enclose them with underscores. Example: Text containing one _italic_ word becomes Text containing one italic word

  • To use strikethrough, enclose the words with the hyphenExample: a text with a -strikethrough- word becomes a text with a strikethrough word

enumerations

Simple bullet points as well as numbered lists are supported. Since this is a block element, please end the list with a blank line.

bullet points

For simple bullet points, precede each line of your bulleted list with an asterisk (asterix) followed by a space.

Example:

* Line one

* Line two

becomes

  • line one

  • line two

Numbered lists

Similarly, the hash followed by a space is used for numbered listings.

Example:

# line one

# line two

becomes:

  1. line one

  2. line two

Bullet point with description

If you want to write an explanatory text for a bullet point, make a line break and write the text without the bullet symbol in front.

Example:

* Line one

An explanatory text that may also span several lines

* Line two

becomes:

  • Line one

    An explanatory text that may span multiple lines

  • line two

Links

To link to other sites, simply paste the appropriate URL. If you would like to place the link on a text, please do so according to the following scheme:

"link text":link url

Example:

becomes:

buttons

In order to get a button that points to a URL, you simply create a link that you also mark with the appropriate "class".

This is done by the class in brackets, which is placed directly in front of the link text:

"(Class)Link-Text":Link-URL

Only the buttonSponsor class is currently available here.

Example:

"(buttonSponsor)contentbird Convert":https://contentbird.io/contentbird-convert

becomes:

Comments

Multi-line comments are replaced by bq. and a trailing space. Since this is a block element, you must insert a blank line at the end.

Example:

bq. A text that can also span several lines.

This line is also included.

becomes

A text that can also span several lines.

This line is also included.

Pictures

External images can be integrated with their URL. To do this, you surround them with two exclamation marks:

!Image URL!

Example:

becomes

Add image text (alt and title attribute).

You can add text to the image. This is written in brackets directly after the URL:

!Image-URL(description text)!

Example:

link image

It is also possible to link the image. To do this, write the desired destination address directly after the second exclamation mark.

!image url!:link url

Example:

Combine image options

The options can also be combined. To equip the image with text and linking, one would then write the following.

!image-url(description text)!:link-url

Example:

preview function

To get a first impression of the formatting of the text, you can call up the preview via the menu. This function is on the icon with the green tick. Please note that the formatting of the text follows the layout of the contentbird cover and can therefore deviate from the presentation in the final integration.

Special keywords

Depending on how the text is used, special keywords are used within the text to provide enhanced functionality.

[toggle]

Add this after an introductory paragraph within a graphic/text combination to prevent subsequent text from appearing until the user clicks an appropriate control. Add a blank line before and after the keyword for readability. The keyword can only be used once in the text.

(button sponsor)

This award is placed in front of a link in evaluation texts, for example in the quiz, and ensures that it is formatted as a button. Several links can be marked accordingly.

The structure is as follows:

"(buttonSponsor)Link Text":Link URL

Example:

"(buttonSponsor)to the offer":https://contentbird.io/contentbird-convert

Did this answer your question?