要在计算机上做笔记,我们很多人都知道典型的: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.它...
它看起来像:
- 准备:
- ISO 已下载。
- 它记录在 USB 上。
- 安装:
- USB 已插入设备。
- 他..
请记住,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
如果你加上三个重音符号和它们后面的名称,一些查看器会显示带有特殊颜色的代码,甚至某些查看器会显示语言的名称。
````蟒蛇 定义测试(): 你好 ````
它会显示这样的内容:
水平线
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 中的转义字符
有时可能需要“转义”某些字符。例如,如果我们在行首放置#,然后放置一个空格,则会创建一个 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 个键盘) |
黑体字 | **文本**(还有两个下划线) |
斜体 | _文本_(也是一个星号) |
~~文字~~ | |
突出显示 | ==文字== |
带下划线的 | 文本 |
功率 | ^ + 数字 |
下标 | 〜文字〜 |
|
'*'、'-' 或 '+' + 文本 |
|
数字 + '.' 或 ')' + 文本 |
第一 第二 第三 |
‘*’、‘-’ 或 ‘+’ + ‘[ ]’ 或 ‘[x]’ + 文本 |
链接 | [锚](链接“标题”) |
意象 | ![替代文字](链接) |
引用 | > 正文 |
Código |
`文本`。 ̀ ̀ ̀ 文本 ̀ ̀ ̀ 块 |
水平线 | '***', '-' 任何一个 '___' |
平局 | 它们的绘图(见上文) |
数学 | 块的$公式$、$$$公式$$$ |
转义字符 | “\“ 在...前面 |