当前位置: 首页 > 科技观察

Markdown新手指南

时间:2023-03-12 05:30:28 科技观察

在我的工作中,我经常要编写代码、编写代码随附的文档、创建网页以及从事文本恢复项目。我在学校的时候也写过几篇正式的论文,其中还包括写课堂笔记,几乎是每节课。我几乎所有的写作都使用Markdown,这对我来说非常节省时间。在本文中,我将分享我使用Markdown的经验。您将了解:什么是Markdown?它是如何工作的?Markdown的基本语法以及如何使用它们。什么是降价?如果您是Markdown的新手,它是一种为网络作者将文本转换为HTML的工具。Markdown文档遵循特定的语法,易于阅读和编写。它们是纯文本,因此可以使用计算机上的任何文本编辑器创建。然后可以将这些文档转换成网页——网页是使用称为HTML的语言标记创建的。Markdown只是一种无需编写HTML代码即可创建网页的方法(即使您知道如何编写)。事实上,如果您不转换为HTML,Markdown甚至是格式化纯文本的好方法。有人曾经这样向我描述Markdown:“It'snotWYSIWYG,it'sWYSIWYG”。然而,Markdown不仅仅是一个简单的格式化系统,它还是一个将纯文本转换为HTML的软件工具。这就是语法很重要的原因。如果你想在网页上开始一个标题,Markdown将根据标题前面的字符创建它。截图中显示了Markdown的一些语法示例:MarkdowntoHTMLconversion那么如何将纯文本文件转换为HTML?JohnGruber的Markdown是一个在命令行上运行的Perl脚本。也就是说,它可以读取您创建的Markdown文本并使用它来构建网页。由于有很多知名的编辑器可以为你做这个转换,我这里尽量避免使用命令行。不仅如此,这些编辑器中的许多都会让您编写文本,同时向您展示网页的外观(称为渲染)。Markdown编辑器一般设置两个框架:左边是你要写文本的地方,右边是用HTML语言给你格式化的文本:大多数Markdown编辑器都有两个窗格来编写和预览文本。写到满意为止,保存Markdown文件即可。就这样,您以后需要编辑和修改时将需要它。文件保存后,您可以使用编辑器将Markdown文档导出为HTML文档。编辑器使用您的Markdown作为参考来创建网页。您的Markdown文档在导出时没有被修改,您仍然拥有源文档,同时创建一个单独的新HTML文档(网页),您可以将其放在Web服务器上。注意:许多Markdown编辑器还可以将您的Markdown文档导出为其他格式,例如.doc、.docx和.pdf。然后您可以了解这些高级设置和您可能需要的其他软件。基本Markdown语法为了给新的Markdown用户一个快速的概述,我将把本节限制在我最常用的语法上。我相信这些将是最有帮助的——您现在可以提高工作效率,同时进一步了解Markdown可以为您做什么。编写标题我经常使用#字符作为标题。这里有六个层次:#一级标题##二级标题###三级标题####四级标题#####五级标题######六级标题还有一种标题类型,就是在文本下划线。我很少使用这种类型的标题,而且仅限于两种:一种是使用=字符的双下划线,导致H1标题。一种是用-字符表示的单下划线生成H2标题:一级标题================二级标题-------------段落段落之间用空行分隔(确保段落之间有一个空行)。不要缩进第一行。使用Tab键或空格键缩进在Markdown中有不同的用途和功能。段落是一段文本,不应使用空格和制表符缩进。它可以有一行或多行。要结束本段并开始新的一段,请按两次Enter键;段落之间用空行分隔。换行符请记住,对于段落,它们必须由一个空行分隔,这是通过按两次回车键来实现的。Markdown对此很严格。Markdown不支持“硬包装”或“固定行长”段落。也就是说,按一次Enter键不会强制文本换行。它可能会出现在编辑器窗口中,但不会出现在HTML中。但是,有时您可能需要拆分段落或换行。Markdown确实有办法做到这一点,但乍一看可能有点奇怪:换行符是用两个或多个空格键完成的,然后按一下回车键。这是一首短诗的例子。每行以两个空格结尾。最后一行,因为它结束了小节,所以没有多余的空格。由于是这节(段)的结尾,所以我双击回车键:咩,咩黑羊,你有羊毛吗?。是的先生。是的先生。满满三袋。在行尾添加两个空格以创建换行符,可能需要一些时间来适应。水平线水平线非常适合将文本分成几个部分。使用三个或更多破折号-,下划线_,或星号*做一条水平线,像这样:---***____你甚至可以在字符之间输入空格between:---我不经常在文章和报告中使用水平线,但它适用于我的期刊、系统日志和课堂笔记。用粗体和斜体强调文本当您希望某个词或短语脱颖而出并引起注意时,您可以将其设为粗体或斜体。可以通过两种方式之一选择斜体和粗体文本。第一种是使用星号*来包含它,第二种是使用下划线_。要将单词或短语设为斜体,请用下划线或星号将文本括起来。要使单词或短语加粗,请使用双下划线或星号将文本括起来:*斜体*加星号。_斜体_有下划线。使用星号显示**粗体**。显示带有下划线的__bold__。记得在两边使用相同的字符。一侧带有星号而另一侧带有下划线的单词或短语无效。相同的字符必须出现在单词或短语的两边。BlockquotesBlockquotes用于直接引用。如果您正在写博客并且想重复本杰明·富兰克林所说的话,您可以使用块引号。右尖括号用于指定块引用:>Thisisablockquote。>>如果要再次进一步块引用,请使用两个右尖括号。在Markdown中添加超链接非常酷。基础版的Markdown语言中创建超链接的方式有3种,这里我只说两种:普通链接和自动链接。第三种链接称为参考链接,Markdown语言的基础版和高级版都支持它。我想给你一个快速的开始。准备好后,您可以查找参考链接。通用链接允许您链接到各种各样的网站。您要使用的网站名称或短语放在方括号中[]。真正的链接地址在括号()中。现在去[Linux中国](https://linux.cn)。通过用尖括号括起链接地址自动连接<>。该链接是一个实际地址(网址或电子邮件地址)。当拼写链接转换为HTML时,它就成为有效链接。当你想拼出文本中的url时,这很有用:AddinganImageLinkImageinMarkdownisalmostthesame链接到一个网站。网站链接和图片链接之间的细微差别在于图片链接以感叹号开头!。图片名称或图片描述放在方括号[]中。实际链接放在括号()中。您可以像这样嵌入图像:![alternatetext](./images/image.jpg)这里是示例图像的链接。这是一个示例链接,没有图片,但它是实际链接应该是什么样子的一个很好的例子:![bill的图片](./images/my_photo_of_me.jpg)列表制作列表的原因有很多。它们可能用作待办事项、大纲中的主题元素、装配项目中的零件清单等。有两种主要类型的列表:无序列表和有序列表。无序列表没有编号;这些是我们在许多文档中看到的列表项。有序列表已编号。要创建有序(编号)列表,只需以数字开头每一行,如下所示:1.第一项。2.第二项。3.第三条。无序列表没有编号,而是在列表中每一项的开头使用星号*、加号+或减号-。我更喜欢使用星号或减号,您可以选择适合您的一个:*第一项。+项目二。-第三条。可以通过缩进将子项添加到有序和无序列表中,如下所示:1.子项一2.子项二Markdown语法备忘单这是一个简短的Markdown语法列表供您参考,此列表已在本摘要中介绍。如果你决定使用Markdown作为你的写作工具,你会发现Markdown让写作变得更加容易。下载PDF格式的Markdown备忘单EpilogueMarkdown可以做的比我描述的要多得多。我写作的很大一部分是用我在这里介绍的Markdown语法完成的——这些是我最常使用的语法,即使在更复杂的项目中也是如此。如果这些看起来太简单,其实很容易分辨。Markdown用于简单的写作任务,但您不必相信我的话。你可以试试看!无需安装Markdown编辑器;你可以在线尝试。这里有几个优秀的在线Markdown编辑器。我这里喜欢用这三个:JohnGruber的DingusEditor.mdDillingerEditor.mdDillinger会让你看到你的Markdown文本实时渲染成HTML的效果。Dingus没有实时预览,但在参考页上有Markdown语法备忘单。使用这些在线编辑器尝试文章中的示例。也尝试自己的想法。这会让你在可能致力于学习更多之前习惯Markdown。