SphinxでMarkdownを扱うには#

SphinxでMarkdown扱えるように設定する。

追加インストール#

  poetry add myst-parser

conf.py#

  extensions = ['myst_parser']
  source_suffix = {
    '.rst': 'restructuredtext',
    '.txt': 'markdown',
    '.md': 'markdown',
  }

確認#

このページはMarkdownで記述。
うまく表示されてるようなのでOK.