[Sphinx]番号付きリストの入れ子ができなかった話

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

結論

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

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

結果

Markdown

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

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

ソース

#. foo

  #. hoge
  #. fuga 

#. bar

  #. hoge
  #. fuga

出力

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

reST(改)

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

参考

reST構文メモ(Hishidama's Sphinx reStructuredText Memo)