Markdown Hacks
概述
大多数使用 Markdown 的人会发现,基本语法 和 扩展语法 要素可以满足他们的需求。但是,如果您使用 Markdown 的时间足够长,您将不可避免地发现它不支持您需要的某些东西。本页提供了绕过 Markdown 限制的提示和技巧。
💡提示: 这些技巧不能保证在您的 Markdown 应用程序中有效。如果你需要经常使用这些技巧,你应该考虑使用 Markdown 以外的工具。
下划线
在网页写作中,你通常不会看到带下划线的文本,可能是因为带下划线的文本几乎等同于链接。然而,如果你正在写一篇论文或报告,你可能需要在单词和短语下划线的能力。像 Bear 和 SimpleNote 这样的几个应用程序提供了对下划线文本的支持,但是 Markdown 本身不支持下划线。如果您的Markdown处理器支持HTML,则可以使用 <ins> HTML标记为文档中的文本加下划线。
1 | Some of these words <ins>will be underlined</ins>. |
渲染后的输出效果如下:
Some of these words will be underlined.
缩进(Tab)
制表符和空格在 Markdown 中有特殊的含义。可以使用 结尾空格 创建换行符,也可以使用制表符创建 代码块。但是,如果您需要使用 tab 键以传统的方式缩进段落,该怎么办呢?Markdown并没有提供一种简单的方法。
最好的选择可能是使用支持缩进的Markdown编辑器。这在面向桌面发布的应用程序中很常见。例如,iA Writer 允许您在应用程序首选项中为编辑器自定义缩进设置。它还提供了模板自定义选项,以便您可以使呈现的文档看起来像您期望的那样,缩进等等。
如果您的 Markdown 处理器支持 HTML ,另一种选择是使用 HTML 实体作为不间断空格( )。这可能是你最后的选择,因为它可能会变得尴尬。基本上,每一个 在您的 Markdown 源中,将被渲染输出中的空格替换。如果你放四个 在段落之前,段落看起来像是缩进了四个空格。
1 | This is the first sentence of my indented paragraph. |
渲染后的输出效果如下:
This is the first sentence of my indented paragraph.
居中
在写论文或报告时,文字居中是必要的。不幸的是,Markdown没有任何文本对齐的概念(一个可能的例外是在使用表格时)。好消息是有一个HTML标记可以使用:<center>。如果你的Markdown处理器支持HTML,你可以把这些标签放在任何你想居中对齐的文本周围。
1 | <center>This text is centered.</center> |
渲染后的输出效果如下:
<center> HTML 标签在技术上是受支持的,但官方已弃用,这意味着它目前可以工作,但您不应该使用它。不幸的是,没有其他纯 HTML 替代品。您可以尝试使用一种 CSS 替代方案。并不是所有的Markdown应用程序都提供 CSS 支持,但是如果你正在使用的那个提供了,这里有一个 <center> 标签的替代方案:
1 | <p style="text-align:center">Center this text</p> |
如果您的 Markdown 应用程序支持此操作,则输出如下所示:
Center this text
颜色
Markdown不允许您更改文本的颜色,但是如果您的 Markdown 处理器支持 HTML,则可以使用 <font> HTML标记。color 属性允许您使用颜色名称或十六进制 #RRGGBB 代码指定字体颜色。
1 | <font color="red">This text is red!</font> |
渲染后的输出效果如下:
This text is red!
<font> HTML 标记在技术上是受支持的,但官方已弃用,这意味着它目前可以工作,但您不应该使用它。不幸的是,没有其他纯 HTML 替代品。您可以尝试使用一种 CSS 替代方案。并不是所有的 Markdown 应用程序都提供 CSS 支持,但是如果你正在使用的那个提供了,这里有一个 <font> 标签的替代方案:
1 | <p style="color:blue">Make this text blue.</p> |
如果您的 Markdown 应用程序支持此操作,则输出如下所示:
Make this text blue.
注释
有些人需要能够在Markdown文件中编写不会出现在呈现输出中的句子。这些注释本质上是隐藏文本。文档的作者可以查看文本,但它不会打印在网页或PDF上。Markdown本身不支持评论,但一些有进取心的人设计了一个解决方案。
要添加注释,请将文本放入括号内,后面跟着冒号、空格和磅号(例如,[comment]: #)。你应该在注释前后放上空行。
1 | Here's a paragraph that will be visible. |
渲染后的输出效果如下:
Here’s a paragraph that will be visible.
And here’s another paragraph that’s visible.
💡提示:这个技巧来自 Stack Overflow。它已经被同行评审并被成千上万的人使用!
警示
在文档中经常使用警示,提醒人们注意警告(warnings)、注释(notes)和提示(tips)。Markdown 没有为警告提供特殊的语法,而且大多数 Markdown 应用程序不支持警告( MkDocs 是个例外)。
然而,如果你需要添加警示,你可以使用带有 表情符号 和 强调 的 块引用 来创建一些看起来与你在其他网站上看到的警告相似的东西。
1 | > :warning: **Warning:** Do not push the big red button. |
渲染后的输出效果如下:
⚠️ Warning: Do not push the big red button.
📝 Note: Sunrises are beautiful.
💡 Tip: Remember to appreciate the little things in life.
图像尺寸
图像的 Markdown 语法不允许指定图像的宽度和高度。如果您需要调整图像的大小,并且您的 Markdown 处理器支持 HTML ,那么您可以使用 <img> HTML 标记和 width 和 height 属性来设置图像的尺寸(以像素为单位)。
1 | <img src="image.png" width="200" height="100"> |
渲染后的输出效果如下:
图片标题
Markdown本身不支持图像标题,但有两种可能的解决方案。
如果您的 Markdown 应用程序支持 HTML,则可以使用 <figure> 和 <figcaption> HTML 标记为图像添加标题。
1 | <figure> |
渲染后的输出效果如下:
💡提示:如果您的 Markdown 应用程序支持 CSS,则可以使用 CSS 为标题的外观设置样式。
在新选项卡打开链接
有些人喜欢创建在新标签或窗口中打开的链接。链接的 Markdown 语法不允许指定目标属性,但如果 Markdown 处理器支持 HTML,则可以使用 HTML 创建这些链接。
1 | <a href="https://www.markdownguide.org" target="_blank">Learn Markdown!</a> |
渲染后的输出效果如下: