龙小树|Markdown语法

断了今生、忘了曾经 提交于 2020-08-06 06:31:13

本来我是打算先写一篇有关于R的,然后再写markdown相关语法,进而去衔接一些应用包,但是由于后续进展不太顺利,导致我自己打算改变一下发布的顺序;但是markdown又是用的频率非常高的一种语言,相比于WDL,WDL是真搞。。。。

所以就先发布markdown的东西,后续的我在考虑考虑该怎么写,请原谅我这个菜鸟新手的知识库较浅的事实。

------------------------------------------------------------------------------------------------------------------

以下是实际内容

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。
Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。
Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
Markdown 编写的文档后缀为 .md, .markdown。

Markdown 应用
Markdown 能被使用来撰写电子书,如:Gitbook。
当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

编辑器
这里推荐使用 Typora 编辑器来实际操作 Markdown 的语法,Typora 支持 MacOS 、Windows、Linux 平台,且包含多种主题,编辑后直接渲染出效果。
支持导出HTML、PDF、Word、图片等多种类型文件。
Typora 官网: https://typora.io/
也可以使用在线编辑器来测试: https://c.runoob.com/front-end/712

标题怎么书写?
标题有两种表示方法:
1.使用 = 和 - 标记一级和二级标题,分别在写完的内容的新起一行标注至少2个对应符号即可。
= 和 - 标记语法格式如下:
我展示的是一级标题
===
2.利用#键表示由大到小的1-6级别标题。
格式为:# 空一格 内容

段落怎么书写?
Markdown 段落没有特殊的格式,直接编写文字就好,段落的换行是使用两个以上空格加上回车。
当然也可以在段落后面使用一个空行来表示重新开始一个段落。

字体怎么确定?
Markdown 可以使用以下几种字体:记住一个斜两个粗三个斜粗,两边*号或_英文符号。
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

分割线(间隔)与删除线以及下划线:
分割线(间隔):
  • 你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线。
           如***,最重要是三个以上以及独立一行的存在。
 
删除线:
  • 如果段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可,
  • 一行三星号,两端双波浪。
下划线:
下划线可以通过两边添加 <u> 标签来实现
<u>下划线<u>

脚注:
Markdown 脚注的格式如下:
[^要注明的文本]

列表的表示:
Markdown 支持有序列表和无序列表。
无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记,只要这几排的文本不在一个竖线上,就会显示出新的图形符号,来表示新的一横。
有序列表使用数字并加上 . 号来表示。
如果想要,在有序列表中嵌套列表,只需要在列表编号的前面添加几个空格即可(至少一个空格)。如果还想嵌套表格,就在多加几个空格或者一个tab键(方便)就好,以此类推。

区块:
  • 说白了就是想引起人们注意,或者是标重点所用的形式。
  • Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号,也可以逐渐递进,多加几个>即可,注意:一个>符号只能管理一行内容,再写新的行时,需要你再写>以做说明。
  • 当区块符号和第一个字间隔5个空格的时候,文字下面会有黑色的阴影显示,也可以产生其他的外观:
  • 也可以在区块中添加列表,使用方法一致。

代码:
  • 如果是段落上的一个函数或片段的代码可以用反引号把它包起来(`),如果是一段则用(```)三个包裹起来。也可以写成(~)符号;
  • 同时,第一个```后面可以加代码的语言类型如:javascript
  • 而将代码写成区块模式,然后鼠标选择全部文字,再按一个制表符(Tab 键)就可以。

网络及图片链接:
链接使用方法如下:
[链接名称](链接地址)/[1]<链接地址>[1]:网址
而图片只是再[]前面添加“!”地址后“内标题”
修改图片大小方法:img标签<>内部修改。是HTML语言中图片的形式。

表格制作:
    Markdown 制作表格使用‘ | ’来分隔不同的单元格,使用‘ -’ 来分隔表头和其他行。
  • 我们可以设置表格的对齐方式:
    • -: 设置内容和标题栏居右对齐。
    • :- 设置内容和标题栏居左对齐。
    • :-: 设置内容和标题栏居中对齐。

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
 
\   反斜线
{ }  花括号
+   加号
#   井字号
`   反引号
[  ]  方括号
-   减号
.   英文句点
_   下划线
(  )  小括号
!   感叹号
*   星号
 

公式:
当你需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。暂时不做深入研究。
TeX以及LaTeX格式:

支持的 HTML 元素:
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等 ,如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

流程图:作为代码的一部分,很有趣:
```flow
st=>start: 开始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
&```
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!