Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Notifications
Mark all as read
« Back to help center

Formatting posts

The most basic formatting is leaving a blank line to start a new paragraph. For short posts containing only words, this is usually all you need. However, more advanced formatting is available. Formatting can be done directly by adding HTML elements, and/or with Markdown.

HTML

The pages you see are ultimately in HTML. Arbitrary HTML can't be allowed because that could break lots of things. However, a certain subset is specifically allowed to provide some control over formatting without giving you the capability to break the larger page.

tags

HTML tags start with <name> and usually end with </name>. Whatever you put between the starting and ending part gets effected by that tag.

The allowed tags are:

  • <a href="URL">text</a>

    Makes text a clickable link. Clicking goes to URL.

  • <img src="URL">

    Inserts the image at URL in-line.

  • <p>

    Starts a new paragraph. The ending </p> is allowed but usually not required.

  • <b>text</b>, <strong>text</strong>

    Writes the text in bold --> b-text, strong-text

  • <i>text</i>, <em>text</em>

    Writes the text in italics --> i-text, em-text

  • <hr>

    Draws a horizontal line.

  • <h1>text</h1> ... <h6>text</h6>

    Headings, with weight 1 to 6. Weight 1 is a top level heading, with the remaining numbers successively more subordinate:

    Heading 1


    Heading 2

    Heading 3

    Heading 4

    Heading 5
    Heading 6
  • <blockquote>text</blockquote>

    Shows the text in a separate block, visually set off from the surrounding text. Use this to show text that you are quoting from elsewhere:

    Four score and seven years ago, not much of any significance happened. This is more rambling to show how long text is wrapped. Blah, blah, blah.
  • <strike>text</strike>, <del>text</del>

    Writes text with a line thru it to show that it is crossed out or deleted:

    strike text
    del text

  • <code>text</code>

    Writes the text in-line in fixed space font:

    In-line code text --> In-line code text <-- In-line code text.

  • <pre>text</pre>

    Writes a block of text in fixed space font. Use this for source code to keep it from getting wrapped and formatted to oblivion:

    begin
      level := TankLevel(sludge.tank);
      thresh := sludge.thresh_high;
      if EpaInspector then begin
        thresh := sludge.thresh_legal;
        end;
      if level > thresh then begin
        PumpOn (sludge);
        end;
    
  • <br>

    Inserts a "break" in flowed text. The following text starts on a new line.

  • <ol> ... </ol>, <ul> ... </ul>

    Lists. OL (ordered list) creates a numbered list. Each entry will have a successive number. UL (unordered list) just puts a bullet in front of each list entry.

    Add list entries with the LI (list item) tag, below.

  • <li>text

    Starts a new entry in the current list. This works for both numbered (OL) and unnumbered (UL) lists.

  • <sup>text</sup>

    Writes text as a superscript --> P = I2R

  • <sub>text</sub>

    Writes text as a subscript --> hFE = 50

  • <section>text</section>

    Defines a separate section of the document.

Special characters

The HTML &xxx; special characters are available. Click on the heading for more information.

Markdown

This site also supports the markdown language CommonMark. This is intended to be a little easier to type than HTML, but be aware that some simple text sequences can have effects on formatting.

Briefly, the markdown language elements are:

  • Bold: **text** is text
  • Italic: *text* or _text_ is text
  • Code/monospace: `text` is text
  • Links: [name](url) cause name to be a link to url
  • Strikethrough: ~~text~~ is text
  • Blockquotes: > text is

    text

  • Bullets: start your lines with * or -
  • Numbered lists: start your lines with 1., 2., etc.
  • Headers: start your line with # for H1, ## for H2, etc. Must have a space between # and the start of your text.
  • Horizontal line: --- on a line on its own.
  • footnotes: use [^1], [^2], etc., inline, and add [^1]: words to the bottom of your post for automatic formatting and linking.

This community is part of the Codidact network. We have other communities too — take a look!

You can also join us in chat!

Want to advertise this community? Use our templates!

Like what we're doing? Support us! Donate