Markdownのほうが先に触ったので、MarkdownでできることはreSTでも出来ると思って引っかかった話。

結論

Markdownでは番号付きリストの中に入れ子があっても同じインデントで番号を振ってくれます。
しかし、reSTでは#を使った自動連番はネストがあると機能しません。

参考サイトによるとreSTはソースを読んでも構造がわかるようにする思想のため
番号はちゃんとソースに書きべきということみたいです。

結果

Markdownでは下記の書き方ができる

1. foo

  1. hoge
  1. fuga

1. bar

  1. hoge
  1. fuga

1. foo
  1. hoge
  2. fuga
2. bar
  1. hoge
  2. fuga

reSTではこんな感じになり、できない

#. foo

  #. hoge
  #. fuga 

#. bar

  #. hoge
  #. fuga

1. foo
  1. hoge
  2. fuga
1. bar
  1. hoge
  2. fuga

reSTで上記のMarkdownのような出力をするには以下のように書く必要がります。

1. foo

  1. hoge
  2. fuga 

2. bar

  1. hoge
  2. fuga

もしくは

1. foo

  #. hoge
  #. fuga 

2. bar

  #. hoge
  #. fuga

1. foo
  1. hoge
  2. fuga
2. bar
  1. hoge
  2. fuga