标签: github-flavored-markdown

所以社区，

我在 GitHub 存储库自述文件中使用嵌入图像（图标、屏幕截图等），今天注意到我的所有图像在不久前（大约一周左右）工作时都已损坏。一些开发人员朋友的存储库显示出相同的症状和浏览器控制台错误：

Refused to load the image 'https://raw.githubusercontent.com.x.912eb622002e804d2d0bc98027f64e5bb4af.9270fa5c.id.opendns.co
m/s/raw.githubusercontent.com/terrencemm2/terrencemm2/main/assets/japanese_flag.png?X-OpenDNS-
Session=_912eb622002e804d2d0bc98027f64e5bb4af9270fa5c_MHRsNPzb_' because it violates the 
following Content Security Policy directive: "img-src 'self' data: github.githubassets.com 
identicons.github.com collector.githubapp.com github-cloud.s3.amazonaws.com 
*.githubusercontent.com".

注意：这些是正确的，并且在单独的选项卡/窗口中显示正确的图像。

通常，我专用了一个名为 的单独的未合并分支media，其中包含我想在自述文件中使用的任何图像，然后像这样链接它们......

选项 1：<img>使用完整的原始内容 URL。
<img src="https://raw.githubusercontent.com/terrencemm2/terrencemm2/main/assets/azure.png" height=14 />

选项 2：<img>使用相对路径。
<img align="right" width="100" height="100" src="../media/logo.png?raw=true">

选项 3：图像 Markdown 语法，参见https://guides.github.com/features/mastering-markdown/。
![Screenshot](../media/screenshot.png?raw=true)

我使用（新的）RStudio 四开引擎创建了一个 Markdown。我想将 .md 上传到 Github 存储库中。然而，很少有元素能够正确渲染。例如，许多表格不渲染，一些 Markdown 代码按原样渲染（例如:::{.column-page}）。

这是我第一次使用四开本。如果我想创建一个尽可能与 Github markdown 引擎兼容的 r markdown，我应该做什么（我不必坚持使用四开）？

我试图表示一个基本向量，以下代码适用于 Visual Studio Code。

我正在使用以下行$\begin{bmatrix}X\\Y\end{bmatrix}$

所有空格均已删除。它应该看起来像这样，

然而，当推送到 Github 时，它无法正确渲染，而只是逐个字母地渲染整个文本，就像不受支持一样。有谁知道如何让以下矢量正确显示？

我使用Jekyll运行一个博客,并且认为我会使用Redcarpet markdown解释器,因为它是由GitHub开发和使用的.

好吧,我碰巧遇到了一个错误,去检查问题,然后发现了这个问题.

Maintainer说:"你可能已经注意到了(har har har har)我没有时间维护Redcarpet了.这不是我的优先考虑(我发现Markdown非常无聊)并且它不是GitHub的优先考虑因素,因为我们没有更长时间在生产中使用它. "

所以...

1. 是否有一个很好的Ruby markdown解释器(即积极开发,具有合理的语法),我可以使用Jekyll(&pygments)？

2. 更好的是,降价解释器的语法类似于(或至少接近)GitHub Flavored Markdown？

我想在GitHub问题中显示来自我的AWS S3存储桶的图像,但GitHub提供的别名源URL无法正常工作.

我的降价:

![test](https://s3-us-west-2.amazonaws.com/gitshoes/screenshot20140422-45272-isuk4x.png)

GitHub生成的HTML:

<img src="https://camo.githubusercontent.com/b02d0cf44d4ba89549749d299ca9fcfb50612ee7/68747470733a2f2f73332d75732d776573742d322e616d617a6f6e6177732e636f6d2f67697473686f65732f73637265656e73686f7432303134303432322d34353237322d6973756b34782e706e67" alt="test" data-canonical-src="https://s3-us-west-2.amazonaws.com/gitshoes/screenshot20140422-45272-isuk4x.png" style="max-width:100%;">

我提供的图片网址(data-canonical-src)有效,但camo.githubusercontent.com刚刚说"未找到".

我尝试使用不同的图像URL,因此问题似乎特定于AWS图像.我已经公开了我的桶的AWS图像,所以这可能也不是问题.

如何垂直对齐下面的图像和图像的文字？

我在降价中添加它的方式是：

<a name="version"></a>[ ![Download](https://api.bintray.com/packages/edsilfer/maven/search-interface/images/download.svg) ](https://bintray.com/edsilfer/maven/search-interface/_latestVersion) - **MIN API VERSION: 16**

我有一个乳胶生成的.toc文件,其中包含大文档的目录.我想将TOC提取到(github-)降价列表,例如使用pandoc.

我有

\contentsline {chapter}{\numberline {1}Introduction}{1}{chapter.1}
\contentsline {section}{\numberline {1.1}Aim and Motivation}{1}{section.1.1}
\contentsline {section}{\numberline {1.2}State of the art}{1}{section.1.2}
\contentsline {section}{\numberline {1.3}Outline}{1}{section.1.3}
\contentsline {chapter}{\numberline {2}Fundamentals}{2}{chapter.2}
...

在我的.toc文件中.

并希望得到这样的东西

1. Introduction
  1.1. Aim and Motivation
  1.2. State-of-the-art
  1.3. Outline
2. Fundamentals

另一种选择是直接从tex文件中提取这些信息(没有内容).但是,我无法让这个工作,我也认为它更容易出错.

有什么建议？

当前正在尝试使用github markdown格式化表格。想拥有类似的东西：

       | col1 | col2
    -- | ---- | ----
    r1 |  r2  |  r3 

但是markdown迫使我将文本放置在表格的第一列中。关于如何维护一个空的第一列标题的任何想法？

Markdown表使用竖线作为字段分隔符,但我需要在某些单元格中写入垂直条.这可能吗？我正在使用GFM(GitHub Flavored Markdown).

我可以以某种方式逃离垂直栏吗？

这不是在GitHub上,而是通过Docusaurus.我不知道Docusaurus使用哪个解析器,但以下工作都没有:

• |- |只是显示(&被转义)
• <code>- 显示任何html(<被转义)
• \|- |仍然充当表格单元格分隔符

更新:

|如果我在反引号中没有它,则有效.所以,至少就目前而言,我只是取消勾选垂直条.例如,a | b变为a|b

我正在使用React,React Markdown和Material-UI创建一个包含一些帮助文档的相当简单的网页.我收到以下控制台错误:

"警告:React无法识别columnAlignmentDOM元素上的prop.如果您故意希望它作为自定义属性出现在DOM中,请将其拼写为小写columnalignment.如果您不小心将其从父组件传递,请将其从DOM中删除元件."

建造和检查时:

<table class="Component-table-207" columnalignment=","><thead><tr><th>Shortcut</th><th>Action</th></tr></thead><tbody><tr><td>Zoom in/out</td><td>Scroll up/down with mouse</td></tr><tr><td>Down/Up Arrow</td><td>Next/Previous Document</td></tr><tr><td>Right/Left Arrow</td><td>Next/Previous Page of current Document</td></tr><tr><td>Page Up/Page Down</td><td>Jump to first/last document in the PDF queue</td></tr><tr><td>Next/Previous Page of current Document</td><td>Page Up/Page Down</td></tr><tr><td>Click drag</td><td>Pan current document</td></tr><tr><td>Ctrl+R</td><td>Refresh the editor</td></tr><tr><td>Ctrl+Z</td><td>Undo</td></tr><tr><td>Ctrl+Y</td><td>Redo</td></tr></tbody></table>

这是我在Markdown.tsx文件中的代码

const renderers = {
  /* eslint-disable-next-line react/prop-types */
  heading: ({ level, ...props }: any) => {
    let variant;
    let paragraph;

    switch (level) {
      case 1:
        variant = 'display1';
        break;
      case 2:
        variant = 'title';
        break;
      case 3: …