本来我是打算先写一篇有关于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语言中图片的形式。
<img src="
http://static.runoob.com/images/runoob-logo.png" width="50%">
表格制作:
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
&```
来源:oschina
链接:https://my.oschina.net/u/4351537/blog/4296641