Notes rendering of code blocks is incorrect

[dignifiedquire]

Given the following documentation.yml

toc:
  - name: About
    description: >+
      The public key is a base64 encoded string of a protobuf containing an RSA DER
      buffer. This uses a node buffer to pass the base64 encoded public key protobuf
      to the multihash for ID generation.

      ```js
      var PeerId = require('peer-id')

      PeerId.create({ bits: 1024 }, (err, id) => {
        console.log(JSON.stringify(id.toJSON(), null, 2)
      })
      ```

      ```
      {
        "id": "Qma9T5YraSnpRDZqRR4krcSJabThc8nwZuJV3LercPHufi",
        "privKey": "CAAS4AQwggJcAgEAAoGBAMBgbIqyOL26oV3nGPBYrdpbv..",
        "pubKey": "CAASogEwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMBgbIqyOL26oV3nGPBYrdpbvzCY..."
      }
      ```

I get the following output using the default theme

[tmcw]

Loading and writing that description:

fs.writeFileSync('foo.txt', yaml.safeLoad(fs.readFileSync('foo.yml', 'utf8')).toc[0].description);

Generates:

The public key is a base64 encoded string of a protobuf containing an RSA DER buffer. This uses a node buffer to pass the base64 encoded public key protobuf to the multihash for ID generation.
```js var PeerId = require('peer-id')
PeerId.create({ bits: 1024 }, (err, id) => {
  console.log(JSON.stringify(id.toJSON(), null, 2)
}) ```
``` {
  "id": "Qma9T5YraSnpRDZqRR4krcSJabThc8nwZuJV3LercPHufi",
  "privKey": "CAAS4AQwggJcAgEAAoGBAMBgbIqyOL26oV3nGPBYrdpbv..",
  "pubKey": "CAASogEwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMBgbIqyOL26oV3nGPBYrdpbvzCY..."
} ```

Switching this style to use | instead of > produces

The public key is a base64 encoded string of a protobuf containing an RSA DER
buffer. This uses a node buffer to pass the base64 encoded public key protobuf
to the multihash for ID generation.

```js
var PeerId = require('peer-id')

PeerId.create({ bits: 1024 }, (err, id) => {
  console.log(JSON.stringify(id.toJSON(), null, 2)
})
```

```
{
  "id": "Qma9T5YraSnpRDZqRR4krcSJabThc8nwZuJV3LercPHufi",
  "privKey": "CAAS4AQwggJcAgEAAoGBAMBgbIqyOL26oV3nGPBYrdpbv..",
  "pubKey": "CAASogEwgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMBgbIqyOL26oV3nGPBYrdpbvzCY..."
}
```

Which is the intended output. That block style tells the YAML parser to keep whitespace, which is necessary for this Markdown input to work. Afaik, we recommend | blocks everywhere we document documentation.yml descriptions - if we don't recommend | somewhere, we should.

[dignifiedquire]

Thanks, you are right, I had the >+ still in from experimenting.

It is still missing any syntax highlighting though, is there something else I need to enable to have that? It is working for examples in regular documentation.

[dignifiedquire]

Thank you @tmcw for the super fast turnaround!