Markdown 其它技巧

个人学习笔记,参考资料来自:中文版英文版

💡 提示: 这些技巧不能保证在您的Markdown应用程序中有效。如果你需要经常使用这些技巧,你应该考虑使用Markdown以外的方法写作。

1. 下划线

带下划线的文本不是您在网络写作中通常看到的,可能是因为带下划线的文本几乎是链接的同义词。但是,如果您正在撰写论文或报告,则可能需要能够为单词和短语添加下划线。像BearSimplenote这样的几个应用程序提供了对文本下划线的支持,但Markdown本身不支持下划线。如果您的Markdown处理器支持HTML,则可以使用HTML标签(ins)为文档中的文本添加下划线。

1
Some of these words <ins>will be underlined</ins>.

2. 空格和制表符

制表符和空格在Markdown中具有特殊含义。可以使用结尾空格创建换行符,也可以使用制表符创建代码块。但是,如果您需要使用Tab键以老式方式缩进段落怎么办?Markdown并没有提供一种简单的方法来做到这一点。

最好的办法可能是使用支持缩进的Markdown编辑器。这在更面向桌面出版的应用程序中很常见。例如:iA Writer允许您在应用程序首选项中自定义编辑器的缩进设置。它还提供模板自定义选项,以便您可以使呈现的文档看起来像您期望的那样,缩进等等。

如果您的Markdown处理器支持HTML,另一种选择是将HTML实体(&nbsp;)用于不间断空格。这可能应该是您最后的选择,因为它可能会变得尴尬。基本上,每个Markdown源都将替换为渲染输出中的空格。因此,如果您在段落之前粘贴四个实例,则该段落看起来就像缩进了四个空格。

1
&nbsp;&nbsp;&nbsp;&nbsp;This is the first sentence of my indented paragraph.

3. 居中

在撰写论文或报告时,具有居中文本的能力是必要的。不幸的是,Markdown没有任何文本对齐的概念(一个可能的例外是使用表格时)。好消息是您可以使用一个HTML标记(center):如果您的Markdown处理器支持HTML,您可以将这些标签放在要居中对齐的任何文本周围。

1
<center>This text is centered.</center>

HTML标记在技术上受支持,但正式弃用,这意味着它现在可以工作,但您不应该使用它。不幸的是,没有另一种纯粹的HTML替代方案。您可以尝试使用CSS替代方案之一。并非所有Markdown应用程序都提供CSS支持,但如果您正在使用的应用程序提供CSS支持,以下是标签的替代方案:

1
<p style="text-align:center">Center this text</p>

4 颜色

Markdown不允许您更改文本的颜色,但如果您的Markdown处理器支持HTML,则可以使用HTML标签(<font>)。该属性允许您使用颜色的名称或十六进制代码指定字体颜色。

1
<font color="red">This text is red!</font>

HTML标记在技术上受支持,但正式弃用,这意味着它现在可以工作,但您不应该使用它。不幸的是,没有另一种纯粹的HTML替代方案。您可以尝试使用CSS替代方案之一。并非所有Markdown应用程序都提供CSS支持,但如果您正在使用的应用程序提供CSS支持,以下是标签的替代方案:

1
<p style="color:blue">Make this text blue.</p>

5 注释

有些人需要能够在他们的Markdown文件中编写不会出现在渲染输出中的句子。这些注释本质上是隐藏的文本。文档的作者可以查看文本,但不会打印在网页或PDF上。Markdown本身并不支持注释,但一些有进取心的人已经设计了一个解决方案。

要添加注释,请将文本放在方括号内,后跟冒号、空格和井号(例如:[]: #)。您应该在注释前后放置空白行。

1
2
3
4
5
Here's a paragraph that will be visible.

[This is a comment that will be hidden.]: #

And here's another paragraph that's visible.

6 告诫

告诫经常在文档中使用,以引起对警告、注释和提示的注意。Markdown没有为告诫提供特殊的语法,大多数Markdown应用程序也不提供对告诫的支持(一个例外是MkDocs)。

但是,如果您需要添加告诫,则可以使用带有表情符号和强调的块引用来创建类似于您在其他网站上看到的告诫的内容。

1
2
3
4
5
> ⚠️ **Warning:** Do not push the big red button.

> 📝 **Note:** Sunrises are beautiful.

> 💡 **Tip:** Remember to appreciate the little things in life.

7 图像大小

图像的Markdown语法不允许您指定图像的宽度和高度。如果您需要调整图像大小并且您的Markdown处理器支持HTML,则可以使用HTML标记来设置图像的尺寸(以像素为单位)。

1
<img src="image.png" width="200" height="100" />

8 图片说明

Markdown本身不支持图像标题,但有两种可能的解决方法。如果您的Markdown应用程序支持HTML,则可以使用HTML标签为图像添加标题。

1
2
3
4
5
6
<figure>
<img src="/assets/images/albuquerque.jpg" alt="Albuquerque, New Mexico" />
<figcaption>
A single track trail outside of Albuquerque, New Mexico.
</figcaption>
</figure>

💡 提示: 如果您的Markdown应用程序支持CSS,则可以使用CSS来设置字幕外观的样式。

如果您的Markdown应用程序不支持HTML,您可以尝试将标题直接放在图像下方并使用强调。

1
2
![Albuquerque, New Mexico](/assets/images/albuquerque.jpg)
_A single track trail outside of Albuquerque, New Mexico._

9 链接目标

有些人喜欢创建在新选项卡或窗口中打开的链接。链接的Markdown语法不允许您指定属性,但是如果您的Markdown处理器支持HTML,则可以使用HTML来创建这些链接。

1
<a href="https://www.markdownguide.org" target="_blank">Learn Markdown!</a>

10 符号

Markdown不提供符号的特殊语法。但是,在大多数情况下,您可以将要使用的任何符号复制并粘贴到Markdown文档中。例如,如果您需要显示圆周率(π),只需在网页上找到该符号并将其复制并粘贴到您的文档中即可。符号应按预期显示在渲染的输出中。

或者,如果您的Markdown应用程序支持HTML,则可以将HTML实体用于要使用的任何符号。例如,如果要显示版权标志(©),则可以将版权的HTML实体(&copy;)复制并粘贴到Markdown文档中。

下面是符号的 HTML 实体的部分列表:

  • 版权 (©) — &copy;
  • 注册商标 (®) — &reg;
  • 商标 (™) — &trade;
  • 欧元 (€) — &euro;
  • 左箭头 (←) — &larr;
  • 上箭头 (↑) — &uarr;
  • 右箭头 (→) — &rarr;
  • 下箭头 (↓) — &darr;
  • 度 (°) — &#176;
  • 圆周率 (π) — &#960;

有关可用HTML实体的完整列表,请参阅维基百科关于HTML 实体的页面。

11 表格格式

Markdown表格是出了名的挑剔。不能使用许多Markdown语法元素来设置表格单元格中文本的格式。但是,至少有两个常见的表问题有解决方法:换行符和列表。

11.1 表格单元格内的换行符

您可以使用一个或多个HTML标记(<br>)分隔表格单元格中的段落。

1
2
3
4
| Syntax    | Description                                 |
| --------- | ------------------------------------------- |
| Header | Title |
| Paragraph | First paragraph. <br><br> Second paragraph. |

11.2 表格单元格内的列表

您可以使用HTML标记在表格单元格中添加列表。

1
2
3
4
| Syntax | Description                                                  |
| ------ | ------------------------------------------------------------ |
| Header | Title |
| List | Here's a list! <ul><li>Item one.</li><li>Item two.</li></ul> |

12 目录

一些像Markdeep这样的Markdown应用程序可以从你的标题自动生成目录,但这并不是所有Markdown应用程序提供的功能。但是,如果您的Markdown应用程序支持标题 ID,则可以使用列表和一些链接为Markdown文件创建目录。

1
2
3
4
5
6
#### Table of Contents

- [Underline](#underline)
- [Indent](#indent)
- [Center](#center)
- [Color](#color)

13 视频

如果您的Markdown应用程序支持HTML,您应该能够通过复制和粘贴YouTubeVimeo等视频网站提供的HTML代码,在Markdown文件中嵌入视频。如果您的Markdown应用程序不支持HTML,则无法嵌入视频,但您可以通过添加图像和视频链接来接近视频。您几乎可以对任何视频服务上的任何视频执行此操作。

由于YouTube使这变得简单,因此我们将以它们为例。以这个视频为例:https://www.youtube.com/watch?v=123456789,网址的最后一部分是视频 ID。我们可以获取该 ID 并将其放入以下模板中:

1
[![Image alt text](https://img.youtube.com/vi/YOUTUBE-ID/0.jpg)](https://www.youtube.com/watch?v=YOUTUBE-ID)

YouTube会为每个视频自动生成一张图片,因此我们可以使用它并将图片链接到YouTube上的视频。替换图像替代文本并添加视频 ID 后,我们的示例如下所示:

1
[![123456789](https://img.youtube.com/vi/123456789/0.jpg)](https://www.youtube.com/watch?v=123456789)