Difference between revisions of "Discord/formatting"

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
Jump to navigation Jump to search
(it seemed like time to have the text-formatting as a separate page)
 
Line 3: Line 3:
 
* '''bold''' is <code>**two asterisks**</code>
 
* '''bold''' is <code>**two asterisks**</code>
 
* ''italic'' is <code>*one asterisk*</code> or <code>_one underscore_</code>
 
* ''italic'' is <code>*one asterisk*</code> or <code>_one underscore_</code>
 +
** They are rendered exactly the same (using {{xmltag|em}}) but parsed differently: "a*b*c" becomes ''abc'' but a_b_c is left unformatted.
 
* <u>underline</u> is <code>__two underscores__</code>
 
* <u>underline</u> is <code>__two underscores__</code>
 
* <s>strike</s> is <code>~~two tildes~~</code>
 
* <s>strike</s> is <code>~~two tildes~~</code>
Line 25: Line 26:
 
* <code>\_</code> will display as <code>_</code>
 
* <code>\_</code> will display as <code>_</code>
 
* This does not seem to work with backticks (<code>`</code>), however.
 
* This does not seem to work with backticks (<code>`</code>), however.
 +
* <code>&gt;&gt;&gt;</code> escapes emoji (haven't had time to explore in order to describe it precisely)

Revision as of 14:24, 10 May 2020

Discord text formatting

Text formatting is similar to a subset of Markdown, although there are differences:

  • bold is **two asterisks**
  • italic is *one asterisk* or _one underscore_
    • They are rendered exactly the same (using <em>) but parsed differently: "a*b*c" becomes abc but a_b_c is left unformatted.
  • underline is __two underscores__
  • strike is ~~two tildes~~
  • code (fixed-pitch inline unformatted text) is `backticks`
    • You can use this format to paste URLs without them becoming links or displaying a preview.
    • To display a link but no preview, surround the URL with angle brackets: <https://htyp.org>. The angle brackets will not be displayed, and preview will be suppressed.
      • Note: Discord's settings refer to the preview as an "embedded link". Previews of links pasted into a discussion can be turned off by revoking this privilege.
  • multiple lines of code can be started with three backticks at the beginning of a line:
```
code lines
code lines
```
  • the initial backticks can have a language designator afterwards, for syntax highlighting:
```php
php code...
```
  • > (right-angle plus a space) will cause the following paragraph to be indented with a vertical bar
  • spoiler text is ||two pipes||: this causes the text to be obscured until clicked on (similar to this but requiring a click rather than mouse-hover)

To display characters that would otherwise be treated as formatting, escape them with a backslash:

  • \* will display as *
  • \_ will display as _
  • This does not seem to work with backticks (`), however.
  • >>> escapes emoji (haven't had time to explore in order to describe it precisely)