✍ How to format posts and articles

Formatting in the forum is a little different. It relies more heavily on a coding intuition which can be tricky to get down at first.

We’re here to help!

Making a new topic or a wiki article

First, depending on which section of the Tech Community you are in, locate the “+New Article/Topic” button in the navigation menu on the right-hand side.

On the Knowledge base/wiki section, if you want to create an article click:
image

Everywhere else, you’ll have forum topic predefined. If you’d like to start a forum discussion or ask a question click:
image

Tapping on it will pull up a text box that collapsed or re-sized up/down. You’ll also notice, there’s a preview on the right of what you type in. Using the preview is a good way to know if your formatting will show upright, or your .gif will load.

Next, you’ll want to start writing!

Normal text will show up normally. There’s also emojis that can be inserted, bullet points and number lists, and quoting. The toolbar is a big help for most things you want to do.

image Here are your standard text formatting settings, such as bold, italic, headers, underlined, or strikethrough text. Don’t hesitate to use the headers and make your paragraphs easier to distinguish.

image Link button will add a hyperlink to the selected text.

preformatted%20text This is the Block Quote and Preformatted Text button. Both will put your text in a grey box and keep the format that you have applied to it.

upload%20images How to upload images, either from your hard drive or from the web by URL.

lists%20button Bullet point and number list buttons.

emoji Your emoji button. There’s a large, searchable list of them!

image The calendar button allows you to add dates and times that can be set to your preferred time zone.

image To refine your content use these buttons to align text in different way than the commonly used left-alignment.

settings Lastly, there’s the settings button. This is for everything else, including building a poll.

Bold, Italics

These work as usual: you can highlight and press ctrl/cmd + B or I, or tap the buttons for Bold or Italics. You can also manually place the “**” or “_” around the text you want to bold or italicize.

Linking

When inserting a hyperlink, highlight the text you want to add a link to, and tap the “Link” button.

image

Block Quote & Preformatted Text

Block Quoting uses the greater than (>) to indent the text into a grey box. If you want to block quote a large amount of text, you can highlight and tap the “” button or add them manually for each new line. To make sure the following text does not get included, press enter twice and check your preview.

For Preformatted Text you’ll want to hit the spacebar 4 (or more) times to format it, or highlight and tap the “</>” button. Preformatted Text is usually used when sharing code, like Donacode, to help keep the correct format for the text.

Learn more about formatting code here:

Inserting Images

Tapping the insert image button will bring up a menu where you can choose to use a web link or choose from a file from your device (computer, phone, tablet, etc) or drag and drop directly into the New Post menu.

Important note: Please keep in mind the max file size is 2 MB (2000 KB).

Sometimes you’ll find a gif doesn’t load because it’s too large to be loaded from the URL. A workaround is to save it directly as a .gif, and upload as a file!

Bullet Points & Number Lists

This is where things get tricky. As before, you can highlight the text you want to be a list, and then tap on numbers or bullet points. But what if you want to make an outline? Indent the list items?

Here’s how!

First you’ll want to begin your list: highlight and tap the type of list you want or manually place. Note the asterisks (*) used for the bullet points.

Choose the line you want to indent, then add two (2) spaces before the asterisk or number. Note the numbers are still numbers after indenting. To combine the list types, replace the number with an asterisk, and tap out two spaces. This will align the format together. If you want to indent further, keep adding on two spaces.

Emojis

A large array of emojis can be inserted into your text box. There are two ways of doing it! First, tap on the emoji icon, and search for the suitable emoji you want to use.

emoji%20menu

Or, tap in your text box, and type a colon : , followed by the emoji’s name.

emoji%20menu%202

Text Post Settings

Here you can make your post “hidden”, blur spoilers if you’re talking about stories, or build a poll.

text%20post%20settings

Hiding Details & Blurring spoilers

Building a Poll

This option is the only one that requires a couple of extra steps. First, choose the type of selection you want for the choices in your poll.

image

Check whether you want to show the people who voted for the poll (this will show who casted their votes so you can see all the members who participated) or keep it anonymous.

poll2

You’ll also want to input your choices. Make sure to format it so that there’s only one (1) choice per line. Make sure you have the purpose of the poll in your text box too or people won’t know what they’re voting on!
If you want the poll to end on a given date, use the feature “Automatically close poll”

image

Which turns into:

Quoting

sharewholepost Button for quoting a whole post/article. You can do this if you’re sharing to another post to relate the topics, share feedback and so on.

To quote a whole post all you need to do is get to the post you would like to quote, open your New Post menu and tap on the Quote Whole Post icon.

Or, you can quote a specific section, by highlighting it with your cursor and tapping “Quote” underneath it.

Tags
Before you finish creating your article or post you will be prompted to select a product tag for the content you enter.

Tags give you the freedom and the ability to post cross-product topics. If you are on a tag page and click the +New Topic/Wiki button that tag will be automatically selected. You can easily select from the predefined list of tags at the bottom of the topic composer.

One last tip!

If you ever do something horrible to your formatting and can’t figure out how to make it go away, the undo hotkey works in most cases! Press ctrl/cmd + z to undo . Continue to tap it to go all the way back to the beginning if you want to!