在markdown中添加灰色区域
Add gray area in markdown
我目前正在编辑 readme.md 文件,我想放置一些文本块灰色区域,例如 this。
他们使用```javascript注释开始用灰色书写,但是当您需要添加文本链接时出现问题。
是否有其他选项可以提供灰框?
更新:
安全
- 摘要
- 测试 123
- 关注testing
假设我希望 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 )
Github 使用自己的降价风格,称为 Github Flavoured Markdown。您想要的效果本质上只是将文本包装在 <code>
标签中。这可以通过以下方式实现:
- 将代码块缩进四个空格
- 将代码块包裹在三组反引号中,在第一组反引号之后使用可选语言进行语法突出显示。
- 将一些内联代码包装在一组反引号中
前两个还将代码包装在 <pre>
标记中以进行格式化。
请注意,颜色不一定非得是灰色。如果您的网站使用 Markdown,您可以使用 CSS 正常更改它。
通常在代码块中包含链接是没有意义的。
您指出的行为是使用 code block。代码块的唯一目的是显示原始代码。 GitHub 选择应用将背景颜色更改为灰色的样式这一事实纯属巧合。他们本可以轻松选择任何其他颜色或 none。
如果你想让一段文本脱颖而出,但仍然呈现为普通的 Markdown 文本,那么你绝对不想要代码块。还有一些其他选项可用。
您可以使用 blockquote:
> - Test 123
> - Follow [testing artifacts](http://2.bp.blogspot.com) (more Unit )
同样,实际样式将取决于您要将 Markdown 发布到的网站上定义的样式。每个站点可能不同。在 Whosebug 上,您会看到一个黄色(橙色?)框,如下所示:
- Test 123
- Follow testing artifacts (more Unit )
在 GitHub 上,您会在左侧看到一个灰色条,并且没有背景阴影,但这是您可能做的最好的事情了。
另一种选择是使用原始 HTML 来定义您自己的块。但是,出于安全原因,GitHub 会将其删除。
GitHub可能不会去掉一个简单的<div>
,但还有其他各种问题。首先,根据 Markdown rules,"Markdown formatting syntax is not processed within block-level HTML tags." 虽然一些 Markdown 实现添加了一种在块级 HTML 内强制 Markdown 处理的方法,但似乎 GitHub 支持其中任何一个。
然后是如何设置 div 样式的问题。您可以分配 class,但是您如何定义 CSS 来设置 class 的样式?您不能在 Markdown 中包含 CSS(GitHub 会将其删除)。虽然可以包含内联样式(使用 div
上的 style
属性),但 GitHub 也会删除 style
属性。
如果您真的想完全控制文档的外观,那么您需要在自己的服务器上托管自己的网站。使用像 GitHub 这样的网站时,您会被他们的选择所困。
我目前正在编辑 readme.md 文件,我想放置一些文本块灰色区域,例如 this。
他们使用```javascript注释开始用灰色书写,但是当您需要添加文本链接时出现问题。
是否有其他选项可以提供灰框?
更新:
安全
- 摘要
- 测试 123
- 关注testing
假设我希望 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 )
Github 使用自己的降价风格,称为 Github Flavoured Markdown。您想要的效果本质上只是将文本包装在 <code>
标签中。这可以通过以下方式实现:
- 将代码块缩进四个空格
- 将代码块包裹在三组反引号中,在第一组反引号之后使用可选语言进行语法突出显示。
- 将一些内联代码包装在一组反引号中
前两个还将代码包装在 <pre>
标记中以进行格式化。
请注意,颜色不一定非得是灰色。如果您的网站使用 Markdown,您可以使用 CSS 正常更改它。
通常在代码块中包含链接是没有意义的。
您指出的行为是使用 code block。代码块的唯一目的是显示原始代码。 GitHub 选择应用将背景颜色更改为灰色的样式这一事实纯属巧合。他们本可以轻松选择任何其他颜色或 none。
如果你想让一段文本脱颖而出,但仍然呈现为普通的 Markdown 文本,那么你绝对不想要代码块。还有一些其他选项可用。
您可以使用 blockquote:
> - Test 123
> - Follow [testing artifacts](http://2.bp.blogspot.com) (more Unit )
同样,实际样式将取决于您要将 Markdown 发布到的网站上定义的样式。每个站点可能不同。在 Whosebug 上,您会看到一个黄色(橙色?)框,如下所示:
- Test 123
- Follow testing artifacts (more Unit )
在 GitHub 上,您会在左侧看到一个灰色条,并且没有背景阴影,但这是您可能做的最好的事情了。
另一种选择是使用原始 HTML 来定义您自己的块。但是,出于安全原因,GitHub 会将其删除。
GitHub可能不会去掉一个简单的<div>
,但还有其他各种问题。首先,根据 Markdown rules,"Markdown formatting syntax is not processed within block-level HTML tags." 虽然一些 Markdown 实现添加了一种在块级 HTML 内强制 Markdown 处理的方法,但似乎 GitHub 支持其中任何一个。
然后是如何设置 div 样式的问题。您可以分配 class,但是您如何定义 CSS 来设置 class 的样式?您不能在 Markdown 中包含 CSS(GitHub 会将其删除)。虽然可以包含内联样式(使用 div
上的 style
属性),但 GitHub 也会删除 style
属性。
如果您真的想完全控制文档的外观,那么您需要在自己的服务器上托管自己的网站。使用像 GitHub 这样的网站时,您会被他们的选择所困。