标题上方的图片（Github README.rst）答案

【问题标题】：Image above title (Github README.rst)标题上方的图片（Github README.rst）
【发布时间】：2020-08-07 07:13:59
【问题描述】：

我试图在文档标题之前放置一个居中的图像，但后者一直强制自己置顶；如果我在两者之间插入一个|，那么====、----，以及所有后续的节标题都要小得多。 Markdown 没有这个问题。

图片可以在.rst中的文档标题之前吗？

我的做法：

.. raw:: html

    <p align="center"><img src=""></p>

Title
=====

【问题讨论】：

【解决方案1】：

标题和副标题应加上下划线。

还有raw is not recommended。 image 指令是首选。它有一个 :align: center 选项，或者可以使用自定义 CSS :class: 选项设置样式。

以下内容适用于我，其中呈现的 HTML 是 <h1>Title</h1>，根据需要和标题上方的图像。

.. image:: relative-path-to/image.*
    :align: center

=====
Title
=====

【讨论】：

Doesn't work（与本地文件路径相同）vs markdown
您的意思是在您的README.rst 中吗？文件名 README.rst 来自 GitHub 的 UI，而不是 Sphinx 或 reStructuredText。否则，我会根据您的需要看到标题上方的图像。
图片在标题上方，但既没有居中，也没有正确字体大小的标题。
如果我们的浏览器以某种方式显示不同：.rst vs .md（需要后者）。我在 Firefox 和 Edge 中尝试过。
哦，我明白了。 GitHub 支持 .md，但有 suboptimal support for reST/docutils/Sphinx。我假设您希望由 Sphinx 完成渲染，而不是 GitHub。功能请求！