Markdown continue numbered list

Question

In the following markdown code I want item 3 to start with list number 3  But because of the code block in between markdown starts this list item as a new list  Is there any way to prevent that behaviour   Desired output   1  item 1 2  item 2      Code block      3  item 3   Produced output    item 1 item 2    Code block    item 3

User · Answer

Note that there are also a number of extensions available that will fix this behaviour for specific contexts of Markdown use.

For example, sane_lists extension of python-markdown (used in mkdocs, for example), will recognize numbers used in Markdown lists. You just need to enable this extension arkdown.markdown(some_text, extensions=['sane_lists'])

User · Answer

If you want to have text aligned to preceding list item but avoid having  big  line break  use two spaces at the end of a list item and indent the text with some spaces   Source   dots are spaces  -  of course   1   item1             This is some text 2 item2   Result    item1 This is some text item2

User · Answer

If you happen to be using the Ruby gem redcarpet to render Markdown  you may still have this problem  You can escape the numbering  and redcarpet will happily ignore any special meaning  1   Some heading  text text text text  text text  2   Some other heading  blah blah  more blah blah

User · Answer

As an extension to existing answers  For those trying to continue a numbered list after something other than a code block  For example a second paragraph  Just indent the second paragraph by at least 1 space  Markdown  1  one 2  two   three 3  four  Output   one  two three  four

User · Answer

Use four spaces to indent content between bullet points  1  item 1 2  item 2              Code block         3  item 3   Produces    item 1 item 2   Code block  item 3

User · Answer

I solved this problem on Github separating the indented sub-block with a newline  for instance  you write the item 1  then hit enter twice  like if it was a new paragraph   indent the block and write what you want  a block of code  text  etc   More information on Markdown lists and Markdown line breaks   Example    item one item two   this block acts as a new paragraph  above there is a blank line  item three   some other code  item four

User · Answer

Source    lt span gt 1  lt  span gt  item 1 lt br  gt   lt span gt 2  lt  span gt  item 2     Code block      lt span gt 3  lt  span gt  item 3    Result   1  item 1 2  item 2  Code block  3  item 3

User · Answer

Put the list numbers in parentheses instead of followed by a period     1  item 1  2  item 2  code block   3  item 3

User · Answer

Notice how in Macmade s solution  you can see an extra line of code above the  Code block     Here are two better solutions    Indent the code block by an extra 4 spaces  so usually 8  in this nested list example  12   This will put the code in a  lt pre gt  element  On SO  you can even specify syntax highlight with a  lt  -- language  lang-js -- gt  indented by 4 spaces   1 here due to the nested list     item 1 item 2  Code block  JavaScript   maybe    item 3  Or  just put the Code block within backticks and indent by 4 spaces  here  1 extra because of the nested list   You ll get a regular indented text paragraph  with a  lt code gt  element inside it  This one you can t syntax-highlight    item 1 item 2  Code block item 3    Note  you can click  edit  on this answer to see the underlying Markdown code  No need to save

User · Answer

If you use tab to indent the code block it will shape the entire block into one line  To avoid this you need to use html ordered list      item 1 item 2   Code block   lt ol start  3  gt     lt li gt item 3 lt  li gt     lt li gt item 4 lt  li gt   lt  ol gt

User · Answer

If you don t want the lines in between the list items to be indented  like user Mars mentioned in his comment  you can use pandoc s example lists feature  From their docs        My first example will be numbered  1        My second example will be numbered  2    Explanation of examples        My third example will be numbered  3

User · Answer

Macmade s solution doesn t work for me anymore on my Jekyll instance on Github Pages anymore but I found this solution on an issue for the kramdown github repo  For OP s example it would look like this   1  item 1 2  item 2      Code block        start  3   3  item 3   Solved my issues handily

[markdown] Markdown: continue numbered list

Examples related to markdown