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'])