viewing revision from 3 years ago

WIKI TOOLS

-

commenting

viewhistorytalk



WIKI LIST

Commenting

This page contains some of the more common issues, tips, tricks, and Markdown code formatting usages when sharing comment or wiki content. For a complete list of all formatting usages, you may read the Reddit Markdown Primer or Comment Formatting.

See also: https://www.redditsecrets.com/reddit-formatting-help/

▶ To see how anything on this page is actually coded you can "edit" at the top or "view source" at the bottom right. ◀

Reading

SaidIt uses threaded comments — replies to comments are indented below it.

On the left click the [-] to collapse a branch or entire comment tree.

On the left click the [+] to expand a branch or entire comment tree.

Comments

You may post comments on SaidIt posts and read comments other people have shared. You may even vote on them! Like the posts, comments will rise and fall in the rankings as users vote on them. The more votes you earn, the higher your Comment Karma grows.

Formatting

You may format your comments using the Markdown syntax, exemplified in this quick reference table:

you type: you see:
*italics* italics
_italics_ italics
**bold** bold
__bold__ bold
***bold italics*** bold italics
**_bold italics_** bold italics
___bold italics___ bold italics
super^script superscript
~~strikethrough~~ strikethrough
(4 spaces or tab)preformatted text
Requires an empty line between this code and
any normal text above. Outside this table a
working example is on this page under
Start Lines With Spaces
preformatted text
`preformatted text` preformatted text
Some is `inline code text` here. Some is inline code text here.
[saidit!](https://saidit.net) saidit!
\[saidit!](https://saidit.net) [saidit!](https://saidit.net)
\*escape formatting syntax sorta* *escape formatting syntax sorta
\*escape formatting syntax sorta\* \escape formatting syntax sorta*
\**escape formatting syntax sorta** *escape formatting syntax sorta
\**escape formatting syntax sorta\** \escape formatting syntax sorta\*
This sentence is^partly superscripted. This sentence ispartly superscripted.
This sentence is^(partly superscripted.) This sentence ispartly superscripted.

Superscripted text can also be enclosed in parentheses. Text inside the parentheses can include spaces and text after the closing parenthesis will not be superscripted, even if not separated by a space:

This table can also be accessed from any comment box by clicking the formatting help link.

For more advanced syntax options, see the Official Markdown Syntax.


Common Issues

An issue affects links with special characters in the URL, as are often on Wikipedia and similar websites.

To link to:

http://en.wikipedia.org/wiki/Pica_(disorder)

Escape the problematic characters ( and ) by adding backslashes \ in front of each:

http://en.wikipedia.org/wiki/Pica_\(disorder\)

Applied to named links:

[Pica (disorder)](http://en.wikipedia.org/wiki/Pica_\(disorder\))

Will display as:

Pica (disorder)

A Numbering Issue

If a number is followed by a period at the beginning of a line, Markdown interprets it as a numbered list and always starts at one. (See more on this page under Start Numbered Lines.)

2020. What a year. problematically displays:

  1. What a year.

2020\. What a year. is the solution to display:

2020. What a year.

Line-Breaks Using A Double-Space

Individual line-breaks are ignored, so if you type:

This is one line and_
this is another line

It displays without line-break:

This is one line and this is another line

To display a line-break in your post, add two spaces (shown as underscores) at the end of the first line:

This is one line and__
this is another line

It displays a line-break:

This is one line and
this is another line

Or use a double line-break to start a new paragraph.

Inserting A Blank Line Using A Dash

After a blank line:

  1. line 1
  2. line 3

A small gap displays as:

line 1

line 3

After a blank line, a line with just a single dash with no spaces:

  1. line 1
  2. -
  3. line 4

Will create a larger gap omitting the dash:

line 1

line 4

After a blank line, a line with a dash followed by a space (shown as underscore):

  1. line 1
  2. -_
  3. line 4

Will create a bullet instead of a line gap, without line-break:

line 1

  • line 4

After a blank line, a line with a dash followed by a space (shown as underscore) followed by another blank line:

  1. line 1
  2. -_
  3. line 5

Will create a bullet instead of a line gap, with a line-break:

line 1

line 5

Inserting A Blank Line With  

NBSP = Non-Breaking SPace, the equivalent of a space but without wordwrap

To insert a blank line in your Markdown code, leave and empty line or use the double-space line-break covered on this page, with   followed by double-space (shown as underscores).

No double-spaces are used on the first or second lines, thus the crowding.

The fourth line is an empty line for a small padding space. The fifth line does not ignore the fourth empty line because the third line has the double-space line-breaker.

The sixth line is and empty line for a large padding space.

The eighth line is the   without the double-space line-breaker, thus the shift of the ninth line.

  1. First line
  2. Second line
  3. Third line__
  4. Fifth line__
  5.  __
  6. Seventh line__
  7.  
  8. Ninth line_

Displays as:

First line Second line Third line

Fifth line
 
Seventh line
  Ninth line

For more space options and combinations...

A non-breakingspace with double-space line-breakers  __ can be used multiple times.

A single dash - or empty line works for one line only and cannot be used in multiples.

Note: A single dash - directly following a line of text makes it an Underlined Title explained on this page.

  1. First line
  2.  
  3. Fifth line__
  4.  __
  5. Ninth line__
  6.  __
  7. -
  8. Fourteenth line__
  9. Seventeenth line__
  10. -
  11. -
  12. Twentieth line__
  13.  __
  14. -
  15.  __
  16. Twenty-fifth line__
  17.  __
  18.  __
  19.  __
  20.  __
  21. Thirtieth line.__

Displays as:

First line

 

Fifth line

 

Ninth line

 

Fourteenth line

Seventeenth line

Twentieth line

 

 

Twenty-fifth line
 
 
 
 
Thirtieth line


Line-Starting Characters

Line-starting characters are critically important.

Three dashes --- alone on a line will create a dividing line across the page.

Start Quoted Lines: > Greater-Than

> A fine quote displays as:

A fine quote

Start Bullet Lines: * Asterisk / - Dash

* A fine bullet displays as:

  • A fine bullet
  • Another bullet line follows like this, starting with an asterisk *
    • A bullet line with a space before the asterisk * indents it further
    • A bullet line with two spaces before the asterisk * makes no difference

- A fine bullet displays as:

  • A fine bullet
  • Another bullet line follows like this, starting with a dash -
    • A bullet line with a space before the dash - indents it further
    • A bullet line with two spaces before the dash - makes no difference

Start Numbered Lines: 1. Number & Period

1. A fine number displays as:

  1. A fine number
  2. Another number line follows like this, starting with 5. but is auto numbered
    1. A number line with a space before 3. indents it further
    2. A number line with two spaces before 2. makes no difference

Replace the period . with a bracket ) to display:

1) A fine number 5) Another number line follows like this, starting with 5) but is auto numbered 3) A number line with a space before 3) indents it further 2) A number line with two spaces before 2) makes no difference

Because there were no line-breaks it all clumped together. (See more on this page under A Numbering Issue.) Correct by adding double-space line-breaks at the end each line. (All spaces are shown as underscores):

1) A fine number bracket__
5) Another number bracket line follows like this, starting with5)but is _not_ auto numbered__
_3) A number bracket line with a space before3)will _not_ indent it further__
__2) A number bracket line with two spaces before2)will _not_ indent it further either__

To display:

1) A fine number bracket 5) Another number bracket line follows like this, starting with 5) but is not auto numbered
3) A number bracket line with a space before 3) will not indent it further
2) A number bracket line with two spaces before 2) will not indent it further either

Start Lines With Spaces

Spaces in front of non-bullet lines are ignored - until you add 4 or more spaces to preformat text.

____4 spaces before this sentence will display a tiny indent and preformatted non-word-wrap text, spreading across the width of the page no matter how short or long and will create a horizontal scroll bar if maximum width is exceeded:

4 spaces before this sentence will display a tiny indent and preformatted non-word-wrap text, spreading across the width of the page no matter how short or long and will create a horizontal scroll bar if maximum width is exceeded:

Some normal formatted text without 4 spaces before it to break up the preformatted text mode for this next short example:

4 spaces + short text = still crosses the page

Start Title Lines: # Hash

Starting lines with a # hash or number symbol make them titles of sections or subsections. A space after the hash before the title is optional.

Two hashes starting a line is an alternative and the same as a line of title text followed by the next line of all --- dashes underlining, as all the titles on this page.

That large spaces above and below the titles cannot be edited in Markdown but can be adjusted with CSS.

#One hash shows:

One hash

# Two hashes shows:

Two hashes

### Three hashes shows:

Three hashes

####Four hashes shows:

Four hashes

##### Five hashes shows:

Five hashes
Six hashes (all caps regardless)
# Seven hashes (same as 6+1)
## Eight hashes (same as 6+2) etc...


Underline Titles

The "Underline Titles" immediately above was created with this:

Underline Titles
==========

Underline Titles

The "Underline Titles" immediately above was created with this:

Underline Titles
-----------------

Only One Dash directly following a line of text underlines it as a title. -

Only One Dash directly following a line of text underlines it as a title.

- Only One Dash directly preceding a line of text provides extra padding space above.

Only One Dash directly preceding a line of text provides extra padding space above.


Tables

You can create a table by organizing pipes |, hyphens -, and text within a particular syntax.

Column A | Column B | Column C
---------|----------|----------
A1 | B1 | C1
A2 | B2 | C2

Displays this:

Column A Column B Column C
A1 B1 C1
A2 B2 C2

To change the alignment of the elements in a column, add a colon (:) to the left side, right side, or both sides of the appropriate set of hyphens on the second line.

Column L | Column C | Column R
:--------|:--------:|---------:
A1 | B1 | C1
A2 | B2 | C2

Displays this:

Column L Column C Column R
A1 B1 C1
A2 B2 C2

Note that in both cases, only one hyphen is needed between the pipes on the second line, and no spaces are needed to separate table elements from pipes on the third and fourth lines. Adding multiple hyphens and spaces may be useful for clarity, but they will not affect the final layout.

Lines with table syntax can be preceded with pipe characters, but this is entirely optional.

Pressing enter twice and putting blank lines between lines with table syntax will BREAK table formatting.

HTML Wiki Tables

<table class='wiki'>
<tr>
<td>cell A</td>
<td>cell B</td></tr>
<tr >
<td>cell C</td>
<td>cell D</td></tr>
</table>

Displays this:

cell A cell B
cell C cell D


▶ To see how anything on this page is actually coded you can "edit" at the top or "view source" at the bottom right. ◀




revision by JasonCarswell— view source