# Message board formatting question

**URL:** <https://boards.straightdope.com/t/message-board-formatting-question/940105>\
**Category:** Factual Questions\
**Created:** [April 15, 2021, 9:19pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105 "2021-04-15T21:19:24Z")\
**Posts on this page:** 19\
**Page:** 1

<div class="post-metadata">

**Author:** ![Lucas\_Jackson](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/lucas_jackson/32/303_2.png) [@Lucas\_Jackson](https://boards.straightdope.com/u/Lucas_Jackson)\
**Post date:** [April 15, 2021, 9:19pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/1 "2021-04-15T21:19:24Z")

</div>

On this site (and many other message boards I visit) if I want to make a word italicized I code \< i \>, Or bold \< b \>, or underlined \< u \>. But if I want to quote rather than \< q \> I have to write out the whole word. Why?

---

<div class="post-metadata">

**Author:** ![DMC](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dmc/32/18049_2.png) [@DMC](https://boards.straightdope.com/u/DMC)\
**Post date:** [April 15, 2021, 9:55pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/2 "2021-04-15T21:55:16Z")

</div>

If you’re using angle brackets, that’s typically seen in [HTML](https://www.w3schools.com/html/html_formatting.asp) which doesn’t have a \<quote\> tag, but uses \<blockquote\> instead. Some software, such as Discourse, _partially_ recognize HTML tags. There is a short quote \<q\> in the HTML specification, but it isn’t supported universally and typically just puts double quotes around the text when it is.

If you’re using brackets, what you’re seeing is [BB Code](https://www.bbcode.org/), which I’m pretty sure originated with [UBB (Ultimate Bulletin Board)](https://www.ubbcentral.com/), but was adopted by most forum software providers and was likely heavily influenced by HTML.

As for why some tags are single letters and some are not, you’ll need to ask [Tim Berners-Lee](https://webfoundation.org/about/vision/history-of-the-web/) why he chose \<b\> for bold and \<blockquote\> for quoting.

---

<div class="post-metadata">

**Author:** ![LSLGuy](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/lslguy/32/5813_2.png) [@LSLGuy](https://boards.straightdope.com/u/LSLGuy)\
**Post date:** [April 15, 2021, 11:24pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/3 "2021-04-15T23:24:29Z")

</div>

And then there’s Markdown which lets you make **bold** by surrounding text with two asterisks like \*\*bold\*\* and _italics_ by using one asterisk like \*italics\* .

What you get in Discourse is the unholy overlap of some subset of HTML, some subset of BBCode and some subset of some unknown variant of Markdown. And each of the three isn’t totally internally consistent either.

Which is not to say that’s evil; just that if you’re seeking consistency you’re in totally the wrong place.

---

<div class="post-metadata">

**Author:** ![Hari\_Seldon](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/hari_seldon/32/5173_2.png) [@Hari\_Seldon](https://boards.straightdope.com/u/Hari_Seldon)\
**Post date:** [April 16, 2021, 2:06pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/4 "2021-04-16T14:06:32Z")

</div>

Is there any place where I can find out what Discourse actually recognizes?

---

<div class="post-metadata">

**Author:** ![DMC](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dmc/32/18049_2.png) [@DMC](https://boards.straightdope.com/u/DMC)\
**Post date:** [April 16, 2021, 4:25pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/5 "2021-04-16T16:25:44Z")

</div>

[This post](https://meta.discourse.org/t/post-format-reference-documentation/19197/2) on the Discourse forums from @codinghorror describes the basics, although it certainly isn’t a reference (I don’t believe there is one for this). We also covered a lot of the cool stuff in [this thread](https://boards.straightdope.com/t/how-do-i-post-a-unicode-shrug/939655) on ATMB.

---

<div class="post-metadata">

**Author:** ![DMC](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dmc/32/18049_2.png) [@DMC](https://boards.straightdope.com/u/DMC)\
**Post date:** [April 16, 2021, 4:28pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/6 "2021-04-16T16:28:06Z")

</div>

I also found this unofficial guide.

> **[An Unofficial Discourse User Reference Guide](https://forum.digikey.com/t/an-unofficial-discourse-user-reference-guide/1125)**
>
> This is a “quick” how-to guide for using Discourse forum/community software. It contains a majority of the common features avialble to users/content editors, but may not have complete coverage of the featureset. If anyone sees anything to add or...

---

<div class="post-metadata">

**Author:** ![GreenWyvern](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/greenwyvern/32/2834_2.png) [@GreenWyvern](https://boards.straightdope.com/u/GreenWyvern)\
**Post date:** [April 16, 2021, 4:52pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/7 "2021-04-16T16:52:51Z")

</div>

Discourse supports standard Markdown.

(Markdown includes support for a number of html tags.)

> **[Basic Syntax | Markdown Guide](https://www.markdownguide.org/basic-syntax/)**
>
> The Markdown elements outlined in the original design document.

&nbsp;  
Discourse also includes support for a few BBCode tags. See this post by **CodingHorror** :

> **[Is there any reference documentation for post formatting?](https://meta.discourse.org/t/is-there-any-reference-documentation-for-post-formatting/19197/2)**
>
> A post was split to a new topic: Supported formatting in posts (markdown, BBCode, and HTML)

---

<div class="post-metadata">

**Author:** ![Hari\_Seldon](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/hari_seldon/32/5173_2.png) [@Hari\_Seldon](https://boards.straightdope.com/u/Hari_Seldon)\
**Post date:** [April 17, 2021, 7:52pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/8 "2021-04-17T19:52:42Z")

</div>

Okay, I am going to try something in that guide:

$$H(z)&=\sum\_{k=0}^{n+1}z^{nk}$$

Nope, didn’t work. Latex is my native language, so that would’ve been great.

---

<div class="post-metadata">

**Author:** ![DMC](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dmc/32/18049_2.png) [@DMC](https://boards.straightdope.com/u/DMC)\
**Post date:** [April 17, 2021, 7:59pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/9 "2021-04-17T19:59:15Z")

</div>

> [@Hari\_Seldon](#):
>
> Latex is my native language, so that would’ve been great.

There is a Math plugin for Discourse which would allow that, but it isn’t installed here. (Yet 🙂 )

---

<div class="post-metadata">

**Author:** ![BippityBoppityBoo](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/bippityboppityboo/32/5745_2.png) [@BippityBoppityBoo](https://boards.straightdope.com/u/BippityBoppityBoo)\
**Post date:** [April 17, 2021, 8:08pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/10 "2021-04-17T20:08:39Z")

</div>

> [@Hari\_Seldon](#):
>
> Latex is my native language, so that would’ve been great.

My mind went somewhere utterly else than formatting.

---

<div class="post-metadata">

**Author:** ![DMC](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dmc/32/18049_2.png) [@DMC](https://boards.straightdope.com/u/DMC)\
**Post date:** [April 17, 2021, 8:55pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/11 "2021-04-17T20:55:56Z")

</div>

> [@BippityBoppityBoo](#):
>
> My mind went somewhere utterly else than formatting.

It’s also fun to do a Google search for LaTeX when the head of the company is looking at your screen. Thanks to past searches, the text results were fine. Trying to show screenshots, on the other hand…

---

<div class="post-metadata">

**Author:** ![Dr.Strangelove](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dr.strangelove/32/6613_2.png) [@Dr.Strangelove](https://boards.straightdope.com/u/Dr.Strangelove)\
**Post date:** [April 17, 2021, 9:04pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/12 "2021-04-17T21:04:52Z")

</div>

> [@Hari\_Seldon](#):
>
> Okay, I am going to try something in that guide:
> 
> $$H(z)&=\sum\_{k=0}^{n+1}z^{nk}$$
> 
> Nope, didn’t work. Latex is my native language, so that would’ve been great

Works for me:  
[![](https://latex.codecogs.com/gif.download?H%28z%29%3D%5Csum_%7Bk%3D0%7D%5E%7Bn+1%7Dz%5E%7Bnk%7D%5Cphantom%7B.gif) ](https://latex.codecogs.com/gif.download?H%28z%29%3D%5Csum_%7Bk%3D0%7D%5E%7Bn+1%7Dz%5E%7Bnk%7D%5Cphantom%7B.gif)

Just kidding, I used hackery. I agree that native support would be great.

---

<div class="post-metadata">

**Author:** ![DMC](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dmc/32/18049_2.png) [@DMC](https://boards.straightdope.com/u/DMC)\
**Post date:** [April 17, 2021, 9:10pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/13 "2021-04-17T21:10:50Z")

</div>

I asked for it in [this post](https://boards.straightdope.com/t/how-do-i-post-a-unicode-shrug/939655/20) and even tagged Ed, but I’m assuming this is not on their short-list of things to take care of in the near future.

---

<div class="post-metadata">

**Author:** ![biqu](https://avatars.discourse-cdn.com/v4/letter/b/7feea3/32.png) [@biqu](https://boards.straightdope.com/u/biqu)\
**Post date:** [April 19, 2021, 11:35pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/14 "2021-04-19T23:35:10Z")

</div>

What kind of hackery failed to throw an error when the alignment symbol & was used outside of an aligned environment? I’m surprised the DigiKey forum allowed that post to go uncorrected for so many years.

---

<div class="post-metadata">

**Author:** ![Dr.Strangelove](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dr.strangelove/32/6613_2.png) [@Dr.Strangelove](https://boards.straightdope.com/u/Dr.Strangelove)\
**Post date:** [April 19, 2021, 11:48pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/15 "2021-04-19T23:48:54Z")

</div>

It’s possible that I deleted the alignment symbol to get it to work. But what will really bake your noodle is that it renders correctly even with a final unclosed brace, and that the unclosed brace is crucial for it working in Discourse.

---

<div class="post-metadata">

**Author:** ![Hari\_Seldon](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/hari_seldon/32/5173_2.png) [@Hari\_Seldon](https://boards.straightdope.com/u/Hari_Seldon)\
**Post date:** [April 20, 2021, 3:34pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/16 "2021-04-20T15:34:52Z")

</div>

> [@biqu](#):
>
> What kind of hackery failed to throw an error when the alignment symbol & was used outside of an aligned environment? I’m surprised the DigiKey forum allowed that post to go uncorrected for so many years.

Yes, I wondered that too, but I just copied (part of) their example. Actually that line ended in \\ which I took to mean that somehow an array environment was default. Incidentally, I had to type \\\ to get a double backslash (and five of them to get three).

Bottom line: We still don’t have any real documentation of the Discourse syntax.

---

<div class="post-metadata">

**Author:** ![GreenWyvern](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/greenwyvern/32/2834_2.png) [@GreenWyvern](https://boards.straightdope.com/u/GreenWyvern)\
**Post date:** [April 20, 2021, 4:10pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/17 "2021-04-20T16:10:50Z")

</div>

> [@Hari\_Seldon](#):
>
> Bottom line: We still don’t have any real documentation of the Discourse syntax.

True, but basically it’s just Markdown, and you can check any Markdown reference.

99% of the time Markdown is all you really need.  
&nbsp;

If you want something more fancy, there’s ‘some’ html –

 experiment and you can and see what works.

This is a kbd tag

green  
~~pinkish~~

The only way to underline seems to be to use BBCode.

---

<div class="post-metadata">

**Author:** ![codinghorror](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/codinghorror/32/4242_2.png) [@codinghorror](https://boards.straightdope.com/u/codinghorror)\
**Post date:** [April 25, 2021, 9:46pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/18 "2021-04-25T21:46:00Z")

</div>

Yes, as @GreenWyvern noted, mostly the native language is Markdown, so refer to the official reference:

[https://commonmark.org](https://commonmark.org)

Cheatsheet  
[https://commonmark.org/help/](https://commonmark.org/help/)

Interactive tutorial  
[https://commonmark.org/help/tutorial/](https://commonmark.org/help/tutorial/)

A whitelisted subset of HTML tags is also supported, such as `<ins>`, `<del>`, `<mark>`, `<sub>`, `<sup>`, `<s>/<strike>`… as well as the duplicate stuff like bold, italic… in general you should favor markdown as the “native markup language” of Discourse, but understand that markdown was _always_ designed to live in harmony with HTML, too! 👯‍♀️

I think it’s more useful to phrase this in terms of needs… what do you _need_ to do? What is your goal? What do you intend to accomplish? Answering those questions will allow me to give you the most relevant information.

(I would strongly advise against enabling `$` style math markup here, it’s quite a bit of complex overhead for a site that isn’t fundamentally _about_ mathematics… now if you want to try it out on [https://mathoverflow.net/](https://mathoverflow.net/) or [https://math.stackexchange.com/](https://math.stackexchange.com/) go for it!)

---

<div class="post-metadata">

**Author:** ![Dr.Strangelove](https://sea3.discourse-cdn.com/straightdope/user_avatar/boards.straightdope.com/dr.strangelove/32/6613_2.png) [@Dr.Strangelove](https://boards.straightdope.com/u/Dr.Strangelove)\
**Post date:** [April 25, 2021, 9:58pm UTC](https://boards.straightdope.com/t/message-board-formatting-question/940105/19 "2021-04-25T21:58:03Z")

</div>

> [@codinghorror](#):
>
> I would strongly advise against enabling `$` style math markup here, it’s quite a bit of complex overhead for a site that isn’t fundamentally _about_ mathematics

What overhead? Most users won’t use it. The MathJax plugin, which Discourse already supports (but isn’t enabled here) renders everything on the client. Should be negligible server-side overhead.

There’s no shortage of math-inclined people here. And our general questions subforum in particular gets many math questions, many of which would be better answered with LaTeX support. I know I’d post on more math related topics if it were supported, just because sometimes writing formulas with just sup/sub can get very annoying.
