Markdown 可能是在 PC 上做笔记的最佳方式。我们解释如何使用它

降价

要在计算机上做笔记,我们很多人都知道典型的:Word 或 LibreOffice Writer。对于某些情况来说,这是一个不错的选择,但如果我们想要做笔记,快速做笔记,以某种格式保存它们并用不太重的查看器打开,那么最好使用所谓的 降价。在这里,我们将解释它是什么,文本是如何“标记”的,并且我们将命名一些在 Linux 中有价值的编辑器/查看器。

降价是一个 轻标记,其目标是最大限度地提高输入和输出形式的可读性和出版的便利性。与 HTML 一样,Markdown 根据我们使用的标记以不同的方式显示文本,例如粗体和斜体。它是由约翰·格鲁伯和已故的亚伦·斯沃茨创建的,在不深入了解它的历史的情况下,我们将解释如何使用它。

如何创建 Markdown 文档

创建 Markdown 文档是这样的 我们可以使用任何纯文本编辑器来完成。 HTML 中也是如此,但 Markdown 更容易编写。 HTML 使用输入和输出标记,并且在所有情况下它们都具有小于 () 符号,这对于打字来说不是最舒服的,至少在西班牙语键盘上是这样。我们将在 Markdown 中使用的许多标记也必须放置在每个单词之前和之后,但是使用两个星号与 HTML 使用的符号不同。除了标记之外,您唯一需要的就是使用 .md 或 .markdown 扩展名保存文件。

降价 它没有 HTML 那么多的选项,但他也无意这样做。我们可以在互联网上找到一些与 Markdown 兼容的文档查看器可能不支持的内容,但最常用的是,它们是:

Markdown 中的空格

如果没有这一部分,我就不想开始或结束这篇文章。在某些品牌中,例如标题或列表的品牌,您必须将 符号和文本之间有一个空格。如果没有这些空格,我们可能会得到预期的结果,但它提高了可读性,被认为是很好的做法。

头条新闻

在 HTML 中,它们被称为 小时1-小时6。从语义上讲,它们必须用作索引的组成部分;您不必使用它们来放置更大或更小的文本。理论上,h1 应该只是页面的标题,h2 是 h1 的一部分,h3 是 h2 的一部分,依此类推。例如,本文中的“如何创建 Markdown 文档”是一个 h2,它与 h1 一起位于一般文章中,而“标题标题”和接下来的内容将是 h3,它们是如何创建它们部分的一部分。

在 HTML 中,标签是 TEXT,而在 Markdown 中,它的前面有两个井号:

## 这将是一个 h2

pad数表示header的数量,最大为6个。

粗体、斜体、删除线和突出显示

文本以粗体显示(b o 强烈 HTML 中)和斜体(i o em HTML 中)看起来非常相似,以至于可能会令人困惑。可以放 粗体文本周围带有两个下划线,斜体,两侧各有一个下划线。因此,三个下划线将使文本变为粗体和斜体。与星号完全相同。

为了避免混淆,我建议使用下划线表示斜体,使用两个星号表示粗体:

**粗体**
 _斜体_

某些查看器可能不支持它,但您可以通过在文本前后放置两次 Ñ 小胡子来划掉文本 (~~),并使用在其前后有两个相等符号的标记来突出显示它 (==) 。

~~被淘汰了~~
==突出显示==

我在 VSCode 或某些 Linux 查看器中没有看到突出显示的内容,但我在 Vivaldi 浏览器的注释中看到了它。

如果你想知道如何加下划线,奇怪的是,Markdown 中不存在下划线。如果需要为文本添加下划线,最好使用下划线文本 HTML 标记。

幂和下标

如果我们想放一个 数字提升到另一个,即幂,可以通过输入第一个数字,后跟扬抑符 (^),然后幂:2^4 将显示 2⁴ 来完成。有多种方法可以将数字放在相反的一侧(下标),但与标记文本一样,并非所有处理器都支持它。它是通过文本或数字两侧的 Ñ 胡须来实现的:h~2~或者看起来 h2或者(如果没有看到,想象 2 更低)。

段落

平时 无需对段落使用任何标记,但你必须知道一些事情。它们有所谓的硬突破,一开始你不能输入像下面这样的文本,这会在一首诗中看到:

一月的一天(空间)(空间)
看起来是美好的一天(空间)(空间)
伟大的诗(空间)
博主写道(空​​格)(空格)

在前面的文本中,Markdown 将所有内容放在一行中,但技巧是将 每行末尾有两个空格。通过这种方式,它确实尊重我们正在寻找的东西。或者,您可以添加反斜杠,如果您想放置具有相同格式(粗体、斜体...)的行块,并且整个块的开头只有两个符号,末尾有两个符号,则建议您添加反斜杠。

列表

在 HTML 中,至少有三种类型的列表:有序(前面有数字)、无序(前面有点)和定义, ol, ul y dl 分别在 HTML 中。在 Markdown 中我们有同样的东西,它们将像这样创建:

无序列表

前面有一个破折号:

- 第一个元素
- 第二个元素
- 第三元素

并且还带有星号:

*这将首先进行
*这一秒
*还有第三个

或加法符号:

+ 第一点
+ 第二点
+ 第三点

如果我们想创建一个子列表,我们将放置两个前面的符号而不是一个,三个用于子子列表,依此类推。

- 买
- - 牛奶
- - 饼干

也可以通过缩进(几个空格)来完成。

有序列表

有序列表的创建方法是先放一个数字,后跟一个句点,然后是元素:

1. 首先
2.如下
3. 稍后再说

或者也可以用括号代替句点:

1) 元素1
2) 元素 2

要添加子列表,您必须添加缩进,具体取决于我们想要达到的级别。通常是 4 个空格或 Tab 键给出的任何内容(如果按下它会将光标移动到右侧)。在以下示例中,准备和安装位于最左侧,而中间点是前面的四个空格:

1、准备工作:
    1. ISO 已下载。
    2. 记录在USB上。
2、安装:
    1. USB 已插入设备。
    2.它...

它看起来像:

  1. 准备:
    1. ISO 已下载。
    2. 它记录在 USB 上。
  2. 安装:
    1. USB 已插入设备。
    2. 他..

请记住,Markdown 中的有序列表始终遵循顺序,从来没有更好的说法。它可以用 1., 1., 1. 创建,您将看到 1., 2., 3.. 要打破它们,您必须在中间添加带有双换行符的文本。即便如此,如果您输入 2.,它将继续计数。

数据列表

数据列表是术语后跟定义的列表,可以像这样创建(许多查看器不支持):

第 1 学期
:定义1

第 2 学期
:定义 2a
:定义 2b

要做的事

您可以使用无序列表符号(“-”、“*”或“+”)、空格和方括号创建任务列表。如果有空格,则任务尚未完成;里面有一个“x”,就完成了:

- [ ] 创建文章
- [x] 恭喜新年

它看起来像:

  • ��������
  • 恭喜新的一年

这些列表可以组合起来,每个列表的想象力和需求都可以发挥作用。

Markdown 中的链接

在 Markdown 中添加链接有多种方法:快速或直接、正常和通过引用。最快的是 按原样添加链接,包含协议。例如,https://linuxadictos.com 在大多数兼容 Markdown 的查看器中将被视为可点击的链接。然后我们就有了这种语言的常态和引用。

正常链接的文本放在方括号中,链接及其内容 标题 o 提示 (如果存在,则用引号括起来)在括号中:

[最好的Linux博客](https://linuxadictos.com“或者我们尝试一下”)

通过引用的链接稍微复杂一些,但它们可能很有用,因为如果我们需要进行更改,修改引用将修改所有使用它的链接。语法类似,但文本将放置在方括号中,后面是其他方括号中的引用。参考如下所示。举个例子比一千个字更好:

[最好的Linux博客][LXA]…………[LXA]:https://linuxadictos 

参考文献通常放在文档的末尾。

如果我们想要一个没有超链接的链接出现,我们可以用后重音或开重音(`)包围它,这是一种转义方法,我们稍后会讨论。它会给它一些格式,但它不会链接到任何东西。

ID 链接

Markdown 还允许您创建 链接到带有 ID 的元素。第一种方法是最常见的,但它对我来说从来没有用过:必须将 {#el-id} 添加到标题后面,并且链接(而不是 URL)必须包含 ID。例如,如果你的 Markdown 是“## Images in Markdown {#images}”,[to images](#images) 将导致下一个点。

还有另外两种方法可以将链接添加到 ID:

  • 链接到自动标题:一些文字处理器和一些支持它的查看器会自动添加 ID。如果标头是“A test”,则 ID 相同,但全部为小写,并用连字符替换空格。语法应该是:
[我们希望显示的文本](#a-test)
  • 带有 HTML ID 的链接:此方法是添加一个带有所需 ID 的标签(例如“a”,但不是强制的),并且在开始和结束标签之间没有任何文本,因此它仅充当引用()。该链接与上一点完全相同。

如果我们要寻找的是返回到文档的顶部,那么将哈希标记放在括号之间就足够了。

一个美学技巧:如果我们在代码中添加某个地方 <style>* {scroll-behavior: smooth}</style>,我们会看到位移;不会跳。这个问题是我稍后会解释的:某些范围可能会按原样显示该行而不是隐藏它。

Markdown 中的图像

如果你理解了上一点,你也会理解这一点。 添加图像几乎与链接相同,主要区别是感叹号放在它前面。例如:

![Linux Mint 壁纸](https://www.linuxadictos.com/wp-content/uploads/Fondos-de-screenla-de-Victoria.png“一月推出”)

从上面:

  • ! 表明它是一个图像。
  • [] 它们包含替代文本,即 HTML 的“alt”属性。
  • () 它们包含图像的链接,即 HTML“src”属性。
  • 您可以将 HTML 中的信息文本“标题”放在引号之间。没必要吧

如果我们希望图像指向另一个页面,即带有链接的图像,我们所要做的就是将上面的内容括在方括号中,并在其后面添加括号中的链接。

[![Linux Mint 壁纸](https://www.linuxadictos.com/wp-content/uploads/Fundos-de-screenla-de-Victoria.png“这导致 DuckDuckGo”)](https://duckduckgo.com)

与超链接一样,可以通过引用添加链接,但在图像引用中,链接以感叹号开头。

Citas

Markdown 中的引用是通过以大于号开始段落来创建的,例如,Pablinux 说:

> 我想,那么……什么时候吃?

它会显示:

我想,那么……什么时候吃呢?

如果我们需要嵌套引号,将使用更多的大于符号。

> 原始报价
>
>> 引文中提到了什么

它看起来像:

原报价

引文中提到了什么

如果我们希望引用包含空行,则每个空行前面都必须包含符号,包括那些空行:

> 第一个俏皮短语
>
> 预约结束

会显示:

第一个俏皮话

报价结束。

该代码前面添加了一个制表符或四个空格:

(选项卡)sudo pacman -Syu

如果你加上三个重音符号和它们后面的名称,一些查看器会显示带有特殊颜色的代码,甚至某些查看器会显示语言的名称。

````蟒蛇
定义测试():
    你好
````

它会显示这样的内容:

CódigoPython

水平线

Markdown 中的水平线可以通过在一行上仅保留 3 个或更多星号 (***)、破折号 (—) 或下划线 (___) 来创建。结果如下:


平局

Markdown 中的表格基本上是通过绘制它们的图片来创建的:

|第一|第二|第三|
|:------|:------:|------:|
|第一场|第二场|第三场|
|东西|东西2|东西3|

它将显示(但以不同的格式):

第一 第二 第三
第一场 第二场 第三场
算法 算法2 算法3

我们留在细胞中的大小并不重要。;语言将格式化它们。在第二行中,也许是最重要的,我们可以指示文本左对齐、居中对齐或右对齐。冒号(:)表示文本的位置,与此相反,当我们想要将其居中时,我们必须将冒号放在行的前面和后面。

数学公式

Markdown 还允许您添加数学公式。例如,您可以包含前后带有美元符号的在线方程:$x2+y2=z^2$。还用两美元块:

$$\sum_{i=0}^ni^2 = \frac{(n^2+n)(2n+1)}{6}$$

上面的结果在 VSCode 中看起来像这样(第二个 n 前面有一个括号,我错过了):

Markdown 中的数学运算

Markdown 中的转义字符

有时可能需要“转义”某些字符。例如,如果我们在行首放置#,然后放置一个空格,则会创建一个 h1。我们可以通过在前面加上反斜杠来避免这种情况,如下所示:

\# 标题

因此它会按原样显示,没有格式化,也没有转义符号。还有几种方法,但这是最常用的,并且与其他语言相同。

带有 HTML 的 Markdown

降价 部分支持 HTML 标签和 CSS 规则,但我不会打赌这一点。并非所有观众所展示的内容都相同,记住这一点很重要。例如,如果我们使用 GitHub Markdown 并且想要对齐图像,请使用 <img align="left"> 我们将让它“浮动” - 浮动意味着下面的东西上升并放置在它旁边 - 左边。它可以放在另一侧使用 right,但 center 选项不起作用,除非它被包裹在像 或 这样的块标签中。

但这可以是一个选择。如果我们想将文本显示为红色,我们可以提取 HTML 和 CSS,用 span 类型的容器包围它,并内联(在标签内)在“style”属性中添加 CSS 规则。例如,如果我们想要控制图像的大小,它可能很有用,但正如我所说,它并不总是有效。

何时不使用 Markdown

Markdown 就是这样,它旨在快速创建内容并用于非常特定的用途。它可以用于个人笔记或作为 HTML 预处理器,但是 如果您必须在不使用它的团队中工作,则不应使用它。最广泛的是使用文字处理器,更具体地说是 Word 及其 .docx,因此如果我打算分享我的工作,我不会使用 Markdown。他们可能甚至不知道如何查看它们,除非我们给他们这样的文章的链接;)

适用于 Linux 的 Markdown 编辑器

这篇文章比预期的要长,也许值得将其留到另一篇文章中。也许顺便提及一些是个好主意,例如 乔普林撇号 或 Visual Studio Code,适合那些希望将所有内容集中在一处的用户。与查看器一样,某些默认文档查看器可以显示其内容。

无论您选择什么,都值得使用 Markdown 进行个人笔记。尝试一下,你就会告诉我。

汇总表

目标 句法
标头 # 文本(最多 6 个键盘)
黑体字 **文本**(还有两个下划线)
斜体 _文本_(也是一个星号)
删除线 ~~文字~~
突出显示 ==文字==
带下划线的 文本
功率 ^ + 数字
下标 〜文字〜
  • 第一
  • 第二
  • 第三
'*'、'-' 或 '+' + 文本
  1. 第一
  2. 第二
  3. 第三
数字 + '.' 或 ')' + 文本
第一
第二
第三
‘*’、‘-’ 或 ‘+’ + ‘[ ]’ 或 ‘[x]’ + 文本
链接 [锚](链接“标题”)
意象 ![替代文字](链接)
引用 > 正文
Código `文本`。 ̀ ̀ ̀ 文本 ̀ ̀ ̀ 块
水平线 '***', '-' 任何一个 '___'
平局 它们的绘图(见上文)
数学 块的$公式$、$$$公式$$$
转义字符 “\“ 在...前面

发表您的评论

您的电子邮件地址将不会被发表。 必填字段标有 *

*

*

  1. 负责资料:AB Internet Networks 2008 SL
  2. 数据用途:控制垃圾邮件,注释管理。
  3. 合法性:您的同意
  4. 数据通讯:除非有法律义务,否则不会将数据传达给第三方。
  5. 数据存储:Occentus Networks(EU)托管的数据库
  6. 权利:您可以随时限制,恢复和删除您的信息。