結論： mdx_tableauがいい感じ。

前回の記事ではtable.pyを直接編集してmarkdownのテーブルセル結合を実現したが、
よくよくPython-Markdownのドキュメントを見てたら
Third Party Extensionsにすでにセル結合できるやつがあったわ。

Table cell and row spans: Provides spanned cells and columns in tables. Works with Python Markdown versions 2.6 and 3 under both Python 2 and Python 3.
mdx_spantables: Provides spanned table columns and rows. Works with Python Markdown 2.6; fails with ImportError on Python Markdown 3.
これはPython Markdown 2.6専用のようだ
mdx_tableau: Table markup with row and column spans, per-cell formatting, optional or multiple headers, ….

既にあるならそっちを使った方が良いよね。
というわけで試してみる。

Table cell and row spans

インストール方法

$ pip install git+https://github.com/Neepawa/cell_row_span

mkdocs.ymlに

markdown_extensions:
 - cell_row_span

を追加

実行してみる

| Column 1                | Col 2 | Big row span   |
|:-----------------------:|-------| -------------- |
| r1_c1 spans two cols           || One large cell |
| r2_c1 spans two rows    | r2_c2 |                |
|_^                      _| r3_c2 |                |
|    ______ &#20;         | r4_c2 |_              _|

rowspanはできてるけどcolspanがダメですね…

mdx_tableau

インストール方法

$ pip install git+https://github.com/tableau-tables/python-tableau-parser

python-markdownを*.pyから直接起動するには

markdown.markdown(your_documenti, extensions=[..., 'python-tableau-parser', ...])

~~MkDocsから使用するにはmkdocs.ymlに次の記述を追加する~~

markdown_extensions:
- def_list
- python-tableau-parser
- pymdownx.superfences
~~: :~~

~~とtableau-tablesのREADME.mdには書かれてあったが、~~

$ mkdocs serve
ERROR    -  Config value 'markdown_extensions': Failed to load extension 'python-tableau-parser'.
            ModuleNotFoundError: No module named 'python-tableau-parser'
Aborted with 1 Configuration Errors!

~~となり実行できなかった。~~

cell_row_spanもtableau-tablesもダメでした。
うまくいかないもんである。

tableau-tablesを動くようにするか、
table.pyの変更をThird Party Extension化するか…

~~tableau-tablesのほうが色々機能がありそうなんだけどね。~~

追記

tableau-tablesのissuesにそのものズバリ書いてあった

string-scannerが必要

pip install string-scanner

extension が python-tableau-parser → mdx_tableauに変更
mkdocs.ymlに書くのはpython-tableau-parserではなくmdx_tableau を書く。
つまり

mkdocs.yml

markdown_extensions:
 - mdx_tableau

を追加

使い方

文法はVSCodeのMarkdown Preview Enhancedで使われているセル結合と異なっているが、色々柔軟性があるようだ。
いいじゃん！

記号	説明	説明(原文)
^	上のセルと結合	Merge this cell with the one above it. Multiple cells in a column may be merged
{	左のセルと結合	Merge this cell with the one to its left. Multiple cells in a row may be merged
<	左寄せ	Left align this cell
=	中央寄せ	Center this cell
>	右寄せ	Right align this cell
#	見出しセル	Make this cell a header (use <th>)
.class		Apply the CSS class to this cell

サンプルも載っている。よさげ。

試しに使う

従来の標準的な記法はもちろん使える

| 見出し1 | 見出し2  | 見出し3 |
| ------- | -------- | ------- |
|  a      | b        | c       |
|  d      | e        | f       |
|  g      | h        | i       |

セル結合

| 見出し1 | 見出し2  | 見出し3 |
| ------- | -------- | ------- |
|  a      |{         | c       |
|  d      | e        |{        |
|^        | h        |{        |

複数行の見出し

| 見出し1 | 見出し2  | 見出し3 |
| ------- | -------- | ------- |
|# 見出し4|# 見出し5 |^        |
|  d      | e        |{        |
|^        | h        |{        |

最初の行を |! で始めるとキャプションも付けられる

|! 表１ サンプル |
| 見出し1 | 見出し2  | 見出し3 |
| ------- | -------- | ------- |
|# 見出し4|# 見出し5 |^        |
|  d      | e        |{        |
|^        | h        |{        |

うん、いい感じ