过去在 Jupyter 上工作的 Markdown 中的折叠文本在 GitHub 上不起作用

Question

我在 Markdown 中使用折叠文本来编写代码描述，它在 Jupyter 上运行良好，但当文件上传到 GitHub 时，折叠文本不起作用并显示展开的文本。有谁知道如何解决这个问题？我复制了markdown代码供参考。谢谢！

< Jupyter >

### 1-2. Research for brainstorming, methodology, platforms for the data acquisition <br>
<details>
  <summary>✚ <b><i>1-2-1. Fundamental Analysis</i></b>  (Click to see details)</summary>
Fundamental Analysis is a method of determining a stock's real or "fair market" value by examining related economic and financial factors. The financial ratios of a firm can infer the financial health (or fair market value) of the organization. If the fair market value (intrinsic value or true value) is higher than the market price, the stock is deemed undervalued, and a buy recommendation is given. On the other hand, if the fair market value is lower than the market price, the stock is deemed overvalued, and the recommendation might be not to buy or to sell if the stock is held. We used 17 financial ratios as the indicators to assess stocks for an investment. They also helped to downsize the number of stocks in healthcare for the portfolio optimization modeling. <br>
</details>
<br>

< Uploaded and shown on GitHub >

 "### 1-2. Research for brainstorming, methodology, platforms for the data acquisition <br>\n",
    "<details>\n",
    "<summary>✚ <b><i>1-2-1. Fundamental Analysis</i></b>  (Click to see details)</summary>\n",
    "\n",
    "Fundamental Analysis is a method of determining a stock's real or \"fair market\" value by examining related economic and financial factors. The financial ratios of a firm can infer the financial health (or fair market value) of the organization. If the fair market value (intrinsic value or true value) is higher than the market price, the stock is deemed undervalued, and a buy recommendation is given. On the other hand, if the fair market value is lower than the market price, the stock is deemed overvalued, and the recommendation might be not to buy or to sell if the stock is held. We used 17 financial ratios as the indicators to assess stocks for an investment. They also helped to downsize the number of stocks in healthcare for the portfolio optimization modeling. <br>\n",
 "\n",
    "</details>\n",
    "<br>\n",
    "\n",
    "\n",
    "\n",
    "<details>\n",

我尝试在GitHub上编辑它，但之后文件无法打开。我不知道如何解决 GitHub 上的折叠问题。

Answer 1

我怀疑您正在使用

details

和

summary

标签来制作可折叠/可切换部分（下拉部分）？ （看 包含 markdown 的可折叠部分）。也许不是？或者也许您添加了“加号”？如果您使用示例 Markdown 代码更新您的帖子，那就太好了。

---

随着 GitHub 改进了对在其网站上渲染 Jupyter Notebook 的支持，尤其是在过去几年中，许多新用户开始认为 GitHub 的渲染是他们必须使用的。 GitHub 这样做只是为了方便开发人员，您应该仅将 GitHub 的渲染视为有时有用的预览。

Jupyter 社区提供了一种查看和共享笔记本的解决方案，该解决方案没有让非程序员感到厌烦的 GitHub 缺陷，并且重要的是，支持更多功能。这是nbviewer。

您会看到其他人使用它与其他人共享 Jupyter 笔记本文件的“静态”视图。例如，转到here并单击右侧“Clustergrammer2”标题下方的“nbviewer”徽章。方便的是，这并不需要您将笔记本托管在 GitHub 或网络上其他地方以外的任何地方。您只需将该站点指向您的 GitHub 文件即可。您可以在 nbviewer 处使用表单中生成的 URL，它只会指示 nbviewer 站点从 GitHub 或其他地方获取您的内容。对于 GitHub，可以通过检查几个示例来辨别 URL 的模式。它实际上只是更改了 GitHub 自己的 URL 的开头。一旦您熟悉了 URL 的模式，您就可以从 GitHub 中起草 nbviewer 变体，而无需使用表单。

nbviewer 支持哪些 GitHub 不支持的功能和能力？

几个。

您已找到一个。还有很多其他的。出现的一个大问题是基于 Javascript 的元素（例如一些小部件，尤其是 Plotly 代码）即使在这种“静态”渲染中也保持交互式。

除此之外，更简洁的界面更适合与那些不使用 GitHub 的人共享。 nbviewer 渲染在右上角有一个指向 GitHub 页面的链接，因此如果需要的话，更高级的用户可以遵循该连接。

此能力的示例，附带警告

我最近制作了一个使用此功能并托管在 GitHub 上的

.ipynb

文件。
您可以前往这里在nbviewer中查看。要查找可切换的文本，请搜索“单击此处显示大图像”。您会看到，如果单击文本，它会显示我正在使用该功能隐藏的图像。 这也让我对这种特殊能力提出了一个不幸的警告。

警告：目前此功能尚不完善。
当您在经典 Jupyter 笔记本（版本 7.0.1）和 JupyterLab（版本 3.4.8 和 4.0.3）中查看它时出现的切换三角形目前不会在 nbviewer 或 nbviewer 中显示。我最近才注意到这一点。我怀疑它会得到改进随着更多面向文档的界面（目前是“经典”界面）的底层技术的发展，JupyterLab 很快就会使用 JupyterLab 的技术，并且使用经典笔记本界面的功能已经开始依赖需要在 JupyterLab 中获得更好的支持。 （如果它在 JupyterLab 中得到纠正，那么可能会在 nbviewer 中解决它，或者至少也强调那里需要解决方案。）我会尽力关注有关此问题的问题报告，并用它更新这篇文章。这样也许其他人可以插话说这种能力很重要，并且它会更快而不是更晚得到一些关注。