【问题标题】:Add gray area in markdown在markdown中添加灰色区域
【发布时间】:2016-11-28 22:14:30
【问题描述】:

我目前正在编辑 readme.md 文件,我想放置一些文本块灰色区域,例如 this

他们使用 ```javascript 注释以灰色开始书写,但是当您需要向文本添加链接时会出现问题。

还有其他选项可以提供灰框吗?

更新:

安全

- 摘要

假设我希望 Test 123 文本和后续内容位于灰色区域(如代码)内,我该如何实现?这里的问题在于以下部分中的 URL...

更新 2

## Test 
   <a name="Test"></a><a name="1.1"></a>
   - **Abstract**
    - Test 123
    - Follow  [testing artifacts](http://2.bp.blogspot.com) (more Unit )

【问题讨论】:

  • 您是否尝试在```javascript 之前保留一个新行(输入)?
  • @sajibkhan - 不工作,请查看我的更新...有什么想法吗?

标签: git github markdown


【解决方案1】:

您指向的行为是使用code block。代码块的唯一目的是显示原始代码。 GitHub 选择应用将背景颜色更改为灰色的样式的事实是巧合。他们可以很容易地选择任何其他颜色或根本不选择。

如果您希望一个文本块与众不同,但仍被呈现为正常的 Markdown 文本,那么您绝对不想要代码块。还有一些其他选项可用。

你可以使用blockquote:

 > - Test 123
 > - Follow  [testing artifacts](http://2.bp.blogspot.com) (more Unit )

同样,实际样式将取决于您发布 Markdown 的网站上定义的样式。每个站点可能不同。在 StackOverflow 上,您会看到一个黄色(橙色?)框,如下所示:

在 GitHub 上,您会在左侧看到一个灰色条,并且没有背景阴影,但这可能是您能做的最好的事情。

另一种选择是使用原始 HTML 来定义您自己的块。但是,出于安全原因,GitHub 将删除它。

GitHub 可能不会去掉一个简单的&lt;div&gt;,但还有其他各种问题。首先,根据 Markdown rules,“Markdown 格式化语法不在块级 HTML 标记中处理。”虽然一些 Markdown 实现添加了一种在块级 HTML 中强制进行 Markdown 处理的方法,但 GitHub 似乎不支持其中任何一个。

然后是如何设置 div 样式的问题。您可以分配一个类,但是如何定义 CSS 来设置该类的样式?你不能在你的 Markdown 中包含 CSS(GitHub 会去掉它)。虽然可以包含内联样式(使用 div 上的 style 属性),但 GitHub 也排除了 style 属性。

如果您真的想完全控制文档的外观,那么您需要在自己的服务器上托管自己的网站。使用 GitHub 等网站时,您会被他们的选择所困扰。

【讨论】:

  • 我可以在 Markdown 中放置一个带有 class 的 div 来产生相同的效果吗?如果可以,请提供示例?
  • @RaynD 我刚刚添加到我的答案中。正如我更详细地解释的那样,div 因各种原因无法工作。
【解决方案2】:

Github 使用自己的降价方式,称为Github Flavoured Markdown。您想要的效果本质上只是将文本包装在 &lt;code&gt; 标签中。这可以通过以下方式实现:

  1. 将代码块缩进四个空格
  2. 将代码块包装在三组反引号中,在第一组后使用可选语言进行语法高亮显示。
  3. 将一些内联代码包装在一组反引号中

前两个还将代码包装在 &lt;pre&gt; 标记中以进行格式化。

请注意,颜色不一定是灰色。如果您的网站使用 Markdown,您可以正常使用 CSS 进行更改。

通常在代码块中包含链接是没有意义的。

【讨论】:

  • 谢谢请看我的更新,我怎样才能像代码标记一样实现这个?
  • 在什么情况下它不起作用?请发布您尝试过的示例。
  • 我尝试在第二段末尾的摘要和之后添加,但它不起作用
  • 好的,我刚刚检查过,关于能够在代码块内呈现链接的说法是错误的。这是有道理的,因为代码块的全部目的只是以原始状态呈现代码。您几乎可以肯定不能在 Github README 文件中执行此操作,但如果它在其他地方,您可以使用 CSS 设置 div 的样式来模拟它。
  • 如果它托管在 Github 上则不会,因为它将使用 Github 自己的渲染器。如果您想修改您正在开发的网站的行为,您将使用您选择的 Markdown 渲染器,并且应该可以覆盖它的行为。但是,您应该记住,这些是代码块,它们的目的是显示代码,因此您不应该这样做是有道理的 - 这是一个功能,而不是错误。你总是可以在你的 markdown 中添加一个带有类的 div,然后让背景变成灰色。
猜你喜欢
  • 1970-01-01
  • 2019-01-11
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2014-06-29
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
相关资源
最近更新 更多