Hacker News Reader

Comment by Jtsummers | Hacker News Reader

Two spaces in front of each line of code to make a code block, HN does not use markdown. (_ as spaces):

  __mean =: +/ % #

Becomes:

  mean =: +/ % #

Don't use the surrounding ```...``` because it just becomes noise, and you don't need extra newlines, two lines of code can be adjacent to each other if you prefix each with two spaces:

  line 1
  line 2, no extra newline was used

https://news.ycombinator.com/formatdoc - a very short document describing all the formatting options for HN comments. There aren't many.

View on HN

I appreciate the hint about code blocks. However, the point of markdown is to be readable without special rendering, so I really don't care that much.

I also disagree about not using ```. It's useful when writing markdown in an interface that swallows whitespace.

Except markdown is not easier to read if you clutter your comment (as I've seen other commenters here do) with something like:

```

foo

bar

baz

```

note all the

extra

vertical

whitespace because regular paragraphs get a slight

gap

```

let's

throw

in a

third block

for some reason

```

As code blocks:

  foo
  bar
  baz

  note all the
  extra
  vertical
  whitespace because regular paragraphs get a slight
  gap

  let's
  throw
  in a 
  third block
  for some reason

The former becomes a problem in the discussion because it clutters the space and is harder to read than the latter, especially when you have multiple blocks around the discussion (in one comment or spread out across comments). You may not care, but using code blocks that offer a more compact and clear expression is certainly more courteous.

> You may not care, but using code blocks that offer a note compact and clear expression is certainly more courteous.

I disagree, and so it's not likely "certain".

I do think that nitpicking over formatting is rather unproductive and rude, though. And it had wasted considerably more space than a format that you happen to dislike, but that others are fine with.

Like I said, I don't care. If you do, then that's on you.

Also, Markdown doesn't support ``` fenced code blocks; that's a common misconception. I don't know which Markdown derivative originated them (maybe GFM?) but they ended up in CommonMark.

New Reddit (aka, Really Obnoxious Interface Reddit) uses that as well. Since Old Reddit is the only useable version of Reddit (IMHO), it's really annoying to see people make such extensive use of it as it gets butchered for Old Reddit users.

> Markdown doesn't sorry ``` fenced code blocks

There isn't a single markdown. There are many different flavors, and all of them are markdown. Many include ``` (GitHub, Kdoc, pandoc, reddit, commonmark), especially as it allows you to specify the language if you want. I actually don't know if any tool I use that doesn't support them.

Reply on news.ycombinator.com