Fenced code in bullet lists with GitHub-flavoured MarkDown??

gistfile1.md

Fenced code blocks inside ordered and unordered lists

1. This is a numbered list.

2. I'm going to include a fenced code block as part of this bullet:

   Code
   More Code
   

3. We can put fenced code blocks inside nested bullets, too.

   1. Like this:

      printf("Hello, World!");

   2. The key is to indent your fenced block by (4 * bullet_indent_level) spaces.

   3. Also need to put a separating newline above and below the fenced block.

---

Failed attempts:

1. This is a bullet.
2. This is the end of the first bullet list, with a fenced code block following:

Code
More Code

3. This is the start of a new bullet list. Hey, where is my fenced code? ``` Code More Code

4. Maybe we can do it with indenting?
    Code
    More Code
5. Did that work? No, so we will try with separation:

    Code
    More Code

6. Now I will try more indenting, to match the bullet margin, plus 4:

       Code
       More Code

7.  Well that was disappointing. How about we indent and use backticks together?
       ```
       Code
       More Code
       ```
8. No such luck.

---

* Oh look, it's some [Apache config](http://pygments.org/docs/lexers/#lexers-for-non-source-code-file-types):

    ```apache
    <Directory /foo/bar>
      Order allow,deny
      Deny from all
    </Directory>
    ```

* Wasn't that fun?

What if I wanna keep the Fenced block code close to the line above.

There are two way to do that.

One is delete the blank line between last item and the block code, but conflict with MD031

Other way is, delete the blank space before back quote `, but then the code is outside of the list.

Is there any solution to do this?

From CommonMark Spec, https://spec.commonmark.org/0.30/#example-254

The most important thing to notice is that the position of the text after the list marker determines how much indentation is needed in subsequent blocks in the list item. If the list marker takes up two spaces of indentation, and there are three spaces between the list marker and the next character other than a space or tab, then blocks must be indented five spaces in order to fall under the list item.

• Check for code in list

  line1  
  ticked `line2`
  quoted "line3"
  

Really helpful !

Altho, a few details of that gist could be updated :

• You don't need to have empty lines around your indented code block if you are using bullet lists
• You can use only 2 space * level instead of 4 if you are using bullet lists

Test

• Line1

  ls

  • Line2

    ls -l

Test
----
- Line1
  ```bash
  ls
  ```
  - Line2
    ```bash
    ls -l
    ```

Wow, I love markdown again!

Still valuable in 2023. Thank you!

Thank you for writing this it has helped me. Hopefully you don't mind, but I'd like to make some suggestions:

1. When you say, The key is to indent your fenced block by (4 * bullet_indent_level) spaces., you should also say this applies to the code within the fenced block. In other words, every line of code in the code block need that same (4 * bullet_indent_level) space prefix.
2. Explicitly point out the Raw button at the upper right of your gist. Clicking on that helped me learn my first bullet point.

This is not a suggestion but it might be interesting to some: technically, you only need (3 * bullet_indent_level) spaces. This is true for any thing you want to include in your bullet point that is written on a different line.