University of Bath

Formatting text in the Content Publisher

How to add headings, links, lists, tables and other formatting to your content.

Characters we use in formatting

  • Hash symbol: #
  • Asterisk: *
  • Underscore: _
  • Square bracket: [ ]
  • Round bracket: ( )
  • Vertical bar, also known as Pipe: |
  • Angle bracket: >
  • Dash: -
  • Hard return: ↵ Enter
  • Caret: ^

Headings

To create a large heading (Heading 1), put a hash symbol in front of the text. Follow the heading text with a hard return.

Use multiple hash symbols to indicate Heading 2 and Heading 3.

#Heading 1
##Heading 2
###Heading 3

Each heading looks like this:

This is a Heading 1

This is a Heading 2

This is a Heading 3

New paragraphs

To start a new paragraph, use two hard returns at the end of a line.

Line breaks

To add a single line break (for example, if you're formatting an address in body copy), use two spaces and a hard return at the end of the line.

Bold

Use two asterisks either side of a word to make it bold.

Formatting Displays
This is a **bold** statement. This is a bold statement.

Italics

Use a single underscore either side of a word to italicise it.

Formatting Displays
My favourite book is _Great Expectations_ by Charles Dickens. My favourite book is Great Expectations by Charles Dickens.

Links

To create a link in text, use square brackets around the link text and follow it with the URL in round brackets. Don’t put a space between the brackets.

Formatting Displays
[contents insurance for students](/guides/contents-insurance-for-students) contents insurance for students
Email [web-support@bath.ac.uk](mailto:web-support@bath.ac.uk) Email web-support@bath.ac.uk
[07891 790080](tel:07891790080) 07891 790080

URL formats in links

For links to other bath.ac.uk pages which are in the new Content Publisher, do not include http://www.bath.ac.uk or http://beta.bath.ac.uk. For example:

  • use /guides/contents-insurance-for-students
  • don't use http://www.bath.ac.uk/guides/contents-insurance-for-students

For links to other bath.ac.uk pages which are outside the new Content Publisher (like pages in OpenCMS, Dreamweaver or WordPress), use the full URL, like http://www.bath.ac.uk/hr/staff-survey/index.html

For external links use the full URL. For example: https://www.gov.uk/service-manual/agile-delivery/writing-user-stories.

Email and telephone links

For links to email addresses, add 'mailto:' before the email address inside the round brackets. Don't put a space between 'mailto:' and the email address.

For links to telephone numbers, add 'tel:' before the phone number inside the round brackets. Don't put a space between 'tel:' and the phone number.

For calls to action, if you select 'Email address' or 'Telephone number', you don't need to include 'mailto:' or 'tel:' in the call to action target.

Lists

Ordered lists

For numbered (ordered) lists, use numbers followed by a full stop and a space before the text. Put a hard return after each line, or they will not display as separate list items.

1. Stop
2. Look
3. Listen

  1. Stop
  2. Look
  3. Listen

Unordered lists

Use a single dash followed by a space before each word to give you an unordered (bulleted) list. Put a hard return after each line, or they will not display as separate bullets.

- milk
- eggs
- butter

  • milk
  • eggs
  • butter

Nested lists

After you have created your main bullet point, use a space, then a single dash, followed by a space before each word to create a nested (bulleted) list. Put a hard return after each line or they will not display as separate bullets.

- milk
 - skimmed
 - semi-skimmed

  • milk
    • skimmed
    • semi-skimmed

Featured quotes

To highlight a quote, put an angle bracket in front of a block quote. Don't include quotation marks.

> We cannot solve our problems with the same thinking we used when we created them.

We cannot solve our problems with the same thinking we used when we created them.

Tables

You can build a table row by row by following these instructions. Always put a hard return after each row you create.

First row

The first row contains the headings for each column.

To create a row, start with a vertical space bar (|) then type in your headings.

You do not need to apply any formatting characters to your headings. The Content Publisher will format the heading based on what you do in the second row.

Separate each heading with a vertical space bar.

Example of the first row:

| First Header | Second Header | Third Header |

Second row

For each column in your table, enter a series of dashes separated by the vertical space bar to indicate each column. This row must not contain any of your content.

If you do not create this row, your table will not display properly.

Example of the second row:

| ---------- | ------------ | ------------ |

Other rows

Just follow the same process as for the first row but add your content instead of headings.

You can use formatting like bold, italics and links to format words in table rows, but you can't include line breaks, multiple paragraphs, lists or block quotes.

The vertical space bars that you use as column dividers do not have to be vertically aligned in each row.

| Morning | Afternoon | Evening |
| Beginning | **Middle** | _End_ |

Example of a whole table

| First Header | Second Header | Third Header |
| ---------- | ------------ | ------------ |
| Morning | Afternoon | Evening |
| Beginning | **Middle** | _End_ |

First Header Second Header Third Header
Morning Afternoon Evening
Beginning Middle End

Referencing

Some referencing styles require you to use superscript, like this.1

To add a reference, use a caret (like this ^) followed by a reference number. If you want the reference to appear before the full stop, use round brackets around the number.

If you want to add text with spaces in the reference, put the text in round brackets.

You only need to use superscript when you are referencing work in your academic writing.

Escaping formatting characters

If you need to use a character in your content usually reserved for formatting, placing a backslash (\) in front of the character will allow it to display properly.

Formatting Displays as
I love _italics_ I love italics
I hate \_italics\_ I hate _italics_