Sane Lists

《初回公開：2022/03/26 , 最終更新：未》

原文は

旧バージョンの記事は

【　目次　】

要約

Sane Lists拡張機能は、MarkdownList構文の動作をそれほど驚くべきものではないように変更します。
この拡張機能は、標準のMarkdownライブラリに含まれています。

正常なリストでは、リストタイプを混在させることはできません。
つまり、順序付けされていないリストアイテムが検出された場合、順序付けされたリストは続行されません。その逆も同様です。

例えば：

1. Ordered item 1
2. Ordered item 2

* Unordered item 1
* Unordered item 2

次の出力になります。

<ol>
  <li>Ordered item 1</li>
  <li>Ordered item 2</li>
</ol>

<ul>
  <li>Unordered item 1</li>
  <li>Unordered item 2</li>
</ul>

一方、デフォルトのマークダウン動作は、順序付けされていないリストを生成することです。

デフォルトのマークダウン動作とは異なり、リストアイテムの間に空白行が含まれていない場合、異なるリストタイプは完全に無視されることに注意してください。
これは、段落の動作に対応しています。
例えば。

A Paragraph.
* Not a list item.

1. Ordered list item.
* Not a separate list item.

この拡張機能を使用すると、上記の結果は次のようになります。

<p>A Paragraph.
* Not a list item.</p>

<ol>
  <li>Ordered list item.
  * Not a separate list item.</li>
</ol>

正常なリストは、順序付きリストで使用される番号も認識します。次のリストがあるとします。

4. Apples
5. Oranges
6. Pears

デフォルトでは、マークダウンは最初の行がアイテム番号「4」で始まり、HTMLリストが番号「1」で始まるという事実を無視します。
この拡張により、次のHTML出力が生成されます。

<ol start="4">
  <li>Apples</li>
  <li>Oranges</li>
  <li>Pears</li>
</ol>

一般的な拡張機能の使用法については、拡張機能を参照してください。
拡張機能の名前としてsane_listsを使用します。

ささいな例：

markdown.markdown(some_text, extensions=['sane_lists'])