Guide To Formatting Articles

You may have noticed that the FarkasCity editor lacks buttons for making things italicized or bolded, and for adding links and etc. This is because the FarkasCity editor uses text-based formatting, called Markdown.

This article is a guide to using Markdown to format your blog posts simply. It is arranged from basic to more-complicated things, so you only have to read as much of it as you want to.

Titles

To title your post, put a hash before the first line of your post. For example, this is what the beginning of this post looks like in the editor:

# Guide To Formatting Articles

You may have noticed that the FarkasCity editor…

Formatting text in a paragraph is really simple. To italicize something, surround it in asterisks (stars) like so: To *italicize* something,. For bold, use two stars: For **bold**,.

Links are also fairly simple. You can add a link by simply pasting the URL: https://example.com. You can also add a named link by putting the word(s) in brackets followed by the URL in parenthesis: [named link](https://example.com).

Lists

Markdown supports two types of lists — bulleted and numbered. For bulleted lists, start each line with an asterisk or hyphen and a space. For example,


- Foobar
- Baz
  - Qux

produces

For numbered lists, do the same thing but with numbers:


1. Foobar
2. Baz
   1. Qux

produces

  1. Foobar
  2. Baz
    1. Qux.

Headings

Headings are lines that start with three or more hashes and some space:

### Heading

#### Subheading

##### Sub-subheading

For example, the beginning of this article looks like this:

# Guide To Formatting Articles

You may have noticed that the FarkasCity editor […]

### Titles

Section breaks (horizontal lines)

Section breaks are three or more hyphens on a line by themselves:


---

Block quotes

If you have a large block of text that you want to quote, you can use a block quote. Block quotes look like this:

But as a means of textual emphasis, block quotations sometimes become, like all caps, a form of self-defeating typography. Writers often dump text into a block quotation because they want to signal “This source is really important, so I’ve quoted a lot of it!”

— Matthew Butterick, Practical Typography

To make a block quote, add an greater-than–sign (arrow) at the start of each line break:

> But as a means of textual emphasis, block quotations sometimes become, like all caps, a form of self-defeating typography. Writers often dump text into a block quotation because they want to signal “This source is really important, so I’ve quoted a lot of it!”
> — Matthew Butterick, *Practical Typography*

Images

Random example image

Images are added like descriptive links, except they have an exclamation mark in front of them: ![Description of image](https://example.com/image.png). To get an image link, upload your image somewhere. Next, right-click the image and select “Copy image address” or “Copy image link”. This is so you get the link to just the image instead of the link to the page with the image. Also, make sure to put something descriptive in place of “Description of image” because that is displayed if the image fails to load or if a person has their computer read for them.

So what are you waiting for? Go write something!

#HowTo