网友提问:
谁能通俗的说明白Markdown具体怎么用?
优质回答:
起因:
因为现在的前端基本上都用上了前端构建工具,那就难免要写一些readme等等的说明性文件,但是这样的文件一般都是.md的文件,编写的语法自然跟其他格式的文件有所区别,置于为什么要用这种格式的文件,不要问我,我也不知道,大家都这么用,跟着用就对了,如果有大神知道的,不妨告知小弟,本文也是我学习写markdown文件的一个笔记吧,仅供参考!
正文:1、标题的几种写法:
第一种:
前面带#号,后面带文字,分别表示h1-h6,上图可以看出,只到h6,而且h1下面会有一条横线,注意,#号后面有空格
第二种:
这种方式好像只能表示一级和二级标题,而且=和-的数量没有限制,只要大于一个就行
第三种:
这里的标题支持h1-h6,为了减少篇幅,我就偷个懒,只写前面二个,这个比较好理解,相当于标签闭合,注意,标题与#号要有空格
那既然3种都可以使用,可不可以混合使用呢?我试了一下,是可以的,但是为了让页面标签的统一性,不建议混合使用,推荐使用第一种,比较简洁,全面
为了搞清楚原理,我特意在网上搜一下在线编写markdown的工具,发现实际上是把这些标签最后转化为html标签,如图:
在线地址请看这里: markdown在线编辑 (只是想看看背后的转换原理,没有广告之嫌)
2、列表
我们都知道,列表分为有序列表和无序列表,下面直接展示2种列表的写法:
可以看到,无序列表可以用* , + , — 来创建,用在线编辑器看,实际上是转换成了ul>li ,所以使用哪个都可以,推荐使用*吧
有序列表就相对简单一点,只有这一种方式,注意,数字后面的点只能是英文的点,特别注意,有序列表的序号是根据第一行列表的数字顺序来的,比如说:
第一组本来是3 2 1 倒序,但是现实3 4 5 ,后面一组 序号是乱的, 但是还是显示 3 4 5 ,这点必须注意了
3、区块引用
比如说,你想对某个部分做的内容做一些说明或者引用某某的话等,可以用这个语句
无序列表下方的便是引用,可以有多种用途,看你的需求了,用法就是在语句前面加一个 > ,注意是英文的那个右尖括号,注意空格
引用因为是一个区块,理论上是应该什么内容都可以放,比如说:标题,列表,引用等等,看看下图:
将上面的代码稍微改一下,全部加上引用标签,就变成了一个大的引用,还有引用里面还有引用,那引用嵌套引用还没有别的写法呢?
上图可以看出,想要在上一次引用中嵌套一层引用,只需多加一个>,理论上可以无限嵌套,我就不整那么多了,注意:多层嵌套的>是不需要连续在一起的,只要在一行就可以了,中间允许有空格,但是为了好看,还是把排版搞好吧
4、华丽的分割线
分割线可以由* – _(星号,减号,底线)这3个符号的至少3个符号表示,注意至少要3个,且不需要连续,有空格也可以
应该看得懂吧,但是为了代码的排版好看,你们自己定规则吧,前面有用到星号,建议用减号
5、链接
支持2种链接方式:行内式和参数式,不管是哪一种,链接文字都是用 [方括号] 来标记。
上图可知,行内式的链接格式是:链接的文字放在[]中,链接地址放在随后的()中,举一反三,经常出现的列表链接就应该这样写:
链接还可以带title属性,好像也只能带title,带不了其他属性,注意,是链接地址后面空一格,然后用引号引起来
这是行内式的写法,参数式的怎么写:
这就好理解了,就是把链接当成参数,适合多出使用相同链接的场景,注意参数的对应关系,参数定义时,这3种写法都可以:
[foo]: http://example.com/ “Optional Title Here”
[foo]: http://example.com/ ‘Optional Title Here’
[foo]: http://example.com/ (Optional Title Here)
还支持这种写法,如果你不想混淆的话:
[foo]: <http://example.com/> “Optional Title Here”
其实还有一种隐式链接的写法,但是我觉得那种写法不直观,所以就不写了,经常用的一般就上面2种,如果你想了解隐式链接,可以看我文章最后放出的参考地址
6、图片
图片也有2种方式:行内式和参数式,
用法跟链接的基本一样,唯一的不同就是,图片前面要写一个!(这是必须的),没什么好说的
7、代码框
这个就比较重要了,很多时候都需要展示出一些代码
如果代码量比较少,只有单行的话,可以用单反引号包起来,如下:
要是多行这个就不行了,多行可以用这个:
多行用三个反引号,如果要写注释,可以在反引号后面写
8、表格
这个写的有点麻烦,注意看
从这3种不同写法看,表格的格式不一定要对的非常起,但是为了好看,对齐肯定是最好的,第一种的分割线后面的冒号表示对齐方式,写在左边表示左对齐,右边为右对齐,两边都写表示居中,还是有点意思的,不过现实出来的结果是,表格外面并没有线框包起来,不知道别人的怎么弄的
9、强调
一个星号或者是一个下划线包起来,会转换为<em>倾斜,如果是2个,会转换为<strong>加粗
10、转义
就不一一列举了,基本上跟js转义是一样的
11、删除线
常用的基本上就这些了,如果还有一些常用的,可以跟我留言,我补充上去,我觉得图文并茂才是高效学习的正确姿势,但愿为你的学习带来帮助!
其他网友观点
R Markdown是一种用于在R中生成可重复生成的报告的开源工具。它可以帮助您将所有代码,结果和编写都放在一个地方,并以一种有吸引力且易于消化的方式格式化所有内容。
它也是将您的数据工作展示给其他人的宝贵工具。使用R Markdown,您可以选择将您的作品导出为多种格式,包括PDF,Microsoft Word,幻灯片或HTML文档,以便在网站上使用。
使用R Markdown将数据分析变成漂亮的文档。
R Markdown是一个功能强大的工具,因为它可用于数据分析和数据科学,与他人协作以及将结果传达给决策者。
在大数据分析R Markdownde的使用技巧文章中,我们将介绍在RStudio中使用R Markdown的一些技巧,窍门和快捷方式。
我们喜欢使用R Markdown在R中进行编码和创作内容。实际上,我们在R Markdown中撰写了此大数据分析R Markdownde的使用技巧文章!让我们找出原因!
1.键盘快捷键
知道R Markdown键盘快捷键将在创建报告时节省大量时间。
以下是一些基本的R Markdown快捷方式:
1)Command + Option + I在Mac或Ctrl + Alt + ILinux和Windows 上插入一个新的代码卡盘。
2)Command + Shift + K在Mac或Ctrl + Shift + KLinux和Windows 上,以YAML标头中指定的格式输出文档。“ k”是“编织”的缩写!
接下来,我们将介绍运行代码块的快捷方式。但是在执行此操作之前,通常最好重新启动R会话并从干净的环境开始。Command + Shift + F10在Mac或Ctrl + Shift + F10Linux和Windows 上执行此操作。
1)Command + Option + P在Mac上运行当前块上方的所有块;Ctrl + Alt + P在Linux和Windows上。
2)在Mac 上Command + Option + C或Command + Shift + Enter在Mac上运行当前块;Ctrl + Alt + C或Ctrl + Shift + Enter在Linux和Windows上。
3)Command + Option + N在Mac上运行下一个块;Ctrl + Alt + N在Linux和Windows上。
4)在Mac 上Command + Option + R或Command + A + Enter在Mac上运行所有块;Ctrl + Alt + R或Ctrl + A + Enter在Linux和Windows上。
二、快速预览您的文档
R Markdown提供了许多用于编译文档的格式选项。但是,将您的工作呈现为PDF或演示文稿的时间可能比编译为HTML所需的时间长得多。因此,创作时将文档输出为HTML通常很有用,因为这样可以快速进行迭代。
当您打开一个新的R Markdown文件时,默认输出格式为HTML-编译报告时,您可以在Web浏览器中轻松查看它。此默认设置可以节省您的时间!当您接近成品时,可以将输出更改为您选择的格式,然后进行最后的修饰。
3.知道您的代码块选项
R Markdown的一大优点是,您有许多选择来控制如何评估和呈现每个代码块。这使您可以从头开始构建演示文稿和报告,包括代码,图表,表格和图像,同时仅将基本信息呈现给目标受众。例如,您可以包含结果图,而不显示用于生成结果的代码。
掌握这些代码块选项对于成为熟练的R Markdown用户至关重要:
1)echo = FALSE:隐藏代码,但运行代码并产生所有输出,曲线图,警告和消息。
2)eval = FALSE:显示代码,但不对其进行评估。
3)fig.show = “hide”:隐藏图。
4)include = FALSE:运行代码,但不显示所有输出。这对于设置代码很有帮助。打开新的R Markdown文档时,您可以在第一个代码块中看到一个示例!
5)message = FALSE:防止软件包在加载时打印消息。这也抑制了函数生成的消息。
6)results = “hide”:隐藏打印输出。
7)warning = FALSE:防止软件包和功能显示警告。
4、使用内联代码
使用内联代码将R代码直接嵌入到R Markdown文档中。当您要在书面摘要中包含有关数据的信息时,这很有用。
将内联代码与一起使用,r并添加代码以在反引号内进行评估。例如,在撰写此大数据分析R Markdownde的使用技巧文章时,我们使用了内联代码来为每个部分自动编号,因此我们不必手动添加它们。那么我们是怎么做到的呢?我们首先tip_number在setup代码块中创建一个名为和的变量,然后将值设置为零,如下所示:
然后,将以下内联代码添加到每个部分,以使每次迭代的数目增加一:
嘿,等一下!我们如何在R Markdown中撰写的此大数据分析R Markdownde的使用技巧中包含最后一行代码,而不弄乱下面的部分编号?带有代码块选项!上面的代码示例以代码块形式编写,带有eval = FALSE用于阻止代码运行的选项。像这样:
如您所见,R Markdown是一个功能强大的工具,因为它可以使您对文档的输出进行很多控制!
5.使用TinyTex
借助R Markdown,您可以使用LaTeX文档准备系统输出高质量的报告。当报告包含科学或数学符号以及符号时,LaTeX特别有用。例如,我们在AAA教育中使用LaTeX编写使用数学符号的统计内容。
但是,诸如TeX Live,MiKTeX和MacTeX之类的LaTeX发行版需要大约5 GB的磁盘空间!相反,TinyTex在安装时仅使用约150 MB。
使用install.packages(‘tinytex’)或安装TinyTex tinytex::install_tinytex()。使用卸载TinyTex tinytex::uninstall_tinytex()。
安装TinyTex后,如果您将PDF指定为输出格式,则无需执行其他操作即可输出PDF文档!
要编译一个LaTeX文档为PDF格式,调用其中的一个tinytex功能:pdflatex(),xelatex(),和lualatex()。使用的功能取决于您要使用的LaTeX引擎。
TinyTex开发人员和R Markdown超级巨星谢逸辉说,这是R使用者平均需要了解TinyTex的全部内容。为什么?因为提到的LaTeX功能将自动检测并安装所有缺少的LaTeX软件包!
6.使用R脚本生成R Markdown文档
您是否知道可以从R脚本生成R Markdown文档?为此,请使用捕获注释#’。您甚至可以使用来指定代码块选项#+。这是一个例子:
该R脚本以文件名“ r_script.R”保存。为了将此文档呈现为R Markdown文档,我们spin()从指定函数knitr,如下所示:
以上内容就是小编分享的关于谁能通俗的说明白Markdown具体怎么用?.jpg” />