学习降价:结构、语法和约定

艾德里安试试
分享

Web上的内容需要以HTML格式呈现。许多网络发布工具(如博客软件和cms)将您的内容(文本、图像等)转换为必威滚HTML。但是在很多情况下,您希望自己编写HTML内容,并且手动用HTML标记标记内容是费力的,而且实际上是不可行的。输入减价。

Markdown是一种为Web编写内容的简单、顺畅的方式,也是开发人员创建文档的完美方式。它允许您使用简单的基于文本的标记轻松地构建和格式化文档,然后将其转换为HTML—所有这些都可以在您最喜欢的文本编辑器中完成。

如果你还没有使用Markdown,现在可能是时候开始了。你可以学习基础知识在几分钟内,随着不断使用,语法将成为第二天性。在本文中,我们鼓励您简单地开始,并向您展示如何在创建内容时使用Markdown完成一系列常见任务。

让我们开始吧!

Markdown是什么?

减价是John Gruber在2004年创建的一种轻量级标记语言。它易于编写,易于阅读,并且可以很容易地转换成HTML。它主要是为Web编写而设计的。

它迅速流行起来,现在被用于它的创造者从未设想过的环境中。但它并不完美。它有一些限制,特别是它省略了许多可能需要使用的HTML元素的格式(比如表格)。它也可能有点模棱两可。

因此,人们创造了一系列的变体来处理这些问题:

  • CommonMark试图标准化Markdown,使其不那么模糊,这与过程中的一些原始语法相矛盾。
  • GitHub调味Markdown(GFM)扩展了CommonMark,在GitHub上创建文档时使用。
  • MultiMarkdown添加了新的语法表,脚注,引用,和更多。
  • Pandoc扩展Markdown多种输出格式(不仅仅是HTML),并支持文档元数据,脚注,表格,上标,下标,等等。

一些web服务和Markdown编辑器支持其中一些变体的语法,甚至使用它们自己的Markdown版本。幸运的是,它们都支持原始Markdown语法,这就是我们在本文中将重点讨论的内容。

学习减价

学习Markdown最好的方法就是开始学习。选择一个用例并开始,无论是创建一篇博客文章,处理文档,还是只是向您的笔记添加一些基本的格式。必威滚根据需要逐条学习语法。

您可以使用您最喜欢的文本编辑器,或选择一个设计用于Markdown的众多应用程序。Markdown编辑器可以简化学习过程,因为它们允许您内联或在单独的窗格中预览格式。这意味着您可以一眼看出您是否使用了正确的语法。

就我个人而言,我使用标记为2在我的Mac上预览Markdown文件。这是一个商业产品,但当然你可以为你选择的编辑器找到很多免费的插件。您也可以编辑和预览Markdown文件在线使用Markdown实时预览而且StackEdit

为了帮助选择正确的Markdown编辑器,请参考以下文章:

结构化文档

Markdown允许您向文档添加结构元素,例如标题h1h2h3等等)。在Markdown中有几种添加标题的方法。我最喜欢在标题前加上哈希值,每一级标题一个:

#标题1 #标题2 #标题3 #等等。这是正文。

散列将较低级别的标题进一步向右移动,因此它们看起来是缩进的。你可以选择在行末使用相同数量的散列来关闭标题:

###标题3 ###

还有第二种方法,尽管我不经常看到它被使用。通过在H1标题下加等号,可以创建两级标题符号和H2标题与连字符-

标题1或标题  ================== 标题2  ---------

文档的各个部分可以使用水平的规则<人力资源/ >),或行。您可以在Markdown中使用三个(或更多)连字符来创建这些连字符-,星号、下划线_或等于的迹象。把它们单独放在一行上,两边空行:

简要介绍。=== #第一章大量的文本。第二章再来点文本

列表是另一个重要的结构元素。无序列表(< ul >)是由一行以星号开头创建的,再加上+符号或连字符-,后面跟着一个空格或制表符,然后是文本:

* this *是*无序列表+ this + is + too - so - is - this

选择一个适合你的符号。您可以在这些符号之间切换,最终结果将是相同的。我倾向于使用星号或连字符。

有序列表(< ol >)是数字后面跟着句号。这些数字不一定要按顺序排列。这两种方法都可以:

1.这个2。是3。一个4。命令5。清单1所示。和1。所以1。是1。这

我使用的Markdown编辑器在按下时自动继续列表返回

如果希望以数字和句点开始一行,而不以列表开头,则需要用反斜杠转义句点

2020 \。我们永远不会忘记的一年。

最后,正常文本的段落由一个或多个空行分隔:

这将被格式化为HTML段落。这个也一样。

基本文本格式

基本的文本格式包括粗体和斜体。下划线通常不用于Web,因为它是超链接的格式,所以Markdown不支持它。如果你真的想用,那就用吧<你>HTML标记。(这一点更值得注意。如果Markdown不支持特定类型的HTML元素,则可以使用HTML标记。这里只有一个警告:任何Markdown语法内部HTML标签不会被解析。)

斜体中的单词由一个星号分隔()或下划线(_):

这是*斜体*,_this_也是

粗体字由双星号分隔(**)或下划线(__):

这是**粗体**,__this__也是

有些人喜欢选择下划线或斜体。例如,我通常用星号表示两者* *的* *而且*斜体*

另一些人则喜欢使用不同的符号来区分粗体和斜体,比如:* *的* *而且_italics_

你**也可以**结合它们

块引号和代码块

可以通过在行首使用大于(来创建>)符号,就像旧的电子邮件客户端引用以前的消息:

>这是一个blockquote。单个段落>可以像这样在第二行上继续。可以使用>行加一个大于号来引用多个段落。

我喜欢的方法稍微简单一点,只在每段引用的开头使用大于符号。无论你使用的编辑器是硬包装还是软包装段落,这都是有效的:

你也可以通过在每段的开头加一个大于号来引用段落。嵌套的区块引号也是可能的。

代码块通过将每行缩进至少四个空格或一个制表符来创建:

这是一个正常的段落:这是一个代码块。

但Markdown的其他风格更喜欢使用反撇号。例如,Ulysses在代码块的行首使用了两个反引号:

这是一个代码块。

GitHub风格的Markdown使用三个反引号来开始和结束代码块。Obsidian, Bear和其他Markdown编辑遵循同样的惯例:

这是一个代码块。' ' '

为了将该代码块嵌入到代码块中,我将其包装为四个反引号。在GitHub上,如果你愿意,你可以选择包含该语言语法高亮显示

这是带有语法高亮显示的ruby代码。' ' '

代码可以通过使用单个反勾号分隔符在段落中显示:

这段代码'<大胆的>’将被显示,而不是被解释。

链接和图片

链接和图像使用方括号组合[]和括号().为链接,将锚文本用方括号括起来,然后立即用括号括起URL:

这是一个[网页链接](https://url.com)。

如果你愿意,你可以给链接添加一个标题。当您将鼠标悬停在该链接上时,它将显示为工具提示。在URL后和括号内用引号括起标题:

这是一个[网页链接](https://url.com“此标题将作为工具提示出现”)。

另一种标记链接的方法被称为参考链接.这些看起来像Markdown文档中的脚注,但导出到HTML时将转换为标准链接。这里的目标是使Markdown文档更具可读性。

不是直接链接到URL,而是使用方括号中的标签。然后在文档的其他地方(通常在底部),您将该标签与URL关联:

这是一个[网页链接][mylabel]。[mylabel]: https://url.com "Optional title"或[mylabel]:  (Optional title)

标签不区分大小写,可以由字母、数字、空格和标点符号组成。

图片使用类似的语法,但以感叹号开头():

! (Alt文本)(https://imageurl.com)

如果您愿意,您可以添加一个由括号内的引号括起来的标题。

[Alt text](https://imageurl.com "This is a title")

你也可以使用图片的参考链接:

[mylabel] [mylabel]: https://imageurl.com "这是一个标题"

GitHub调味Markdown额外

许多开发人员使用GitHub调味Markdown,它提供了额外的语法,使其更有能力。这里有一些例子。

加删除线是使用双波浪号实现的附加文本格式选项(~ ~):

这就是你要做的~~击杀~~。

任务列表可以使用以下命令创建- []对于未选中的项,和- [x]检查项目:

-[]未勾选此项。- [x]已勾选此项

您可以创建表格通过使用管道和连字符来绘制线条。三个或更多连字符---创建报头和管道|创建列:

|标题1 |标题2 |标题3 | | --------- | --------- | --------- | |一些文本|更多在这里|和这个| b|一些更多|这个也|和这个|

当列对齐时看起来更好,但这不是必要的。无论哪种方式,当导出到HTML时,表将被正确创建:

|标题1 |标题2 |标题3 | | --------- | --------- | --------- | |一些文本|更多在这里|和这个| b|一些更多|这个也|和这个|

创建这样一个表非常乏味,特别是如果您需要编辑单元格的内容。幸运的是,网上有表生成器这样就简化了过程。

最后的话

Markdown并不适合所有人,但也有很多值得喜欢的地方。就我个人而言,我很欣赏它的开放性、易学性,而且不会把你局限于使用某个特定的程序。

如果您已经看到本文的末尾,那么它可能也是适合您的工具。投入并开始使用它。在你需要的时候一点一点地学习语法,在你知道它之前,它将成为你的第二天性。

请务必下载我们的免费打印Markdown小抄.它涵盖了Markdown的核心语法、一些扩展语法、处理Markdown的工具和其他资源。

Baidu