简书平台Markdown 学习笔记
一、注册账号登录简书,点击头像下设置,常用编辑器勾选Markdown并保存。
二、点击头像右侧写文章,并点击预览模式,在预览模式下一边写作一边检查所写文档的效果。
三、Markdown教程内容
(一)标题
在Markdown中,文本前加入#为标题,标题一共六级,#越多标题等级越低。
注:# 和标题之间保留一个字符的空格,是最标准的 Markdown 写法。
下方为标题的示例:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
(二)列表:
文字前面加上-就是列表;有序列表可以在文字前加上1. 2. 3. 。
注:-和1.与后面文字之间需要有空格。
下面是尝试:
无序列表:
- 肠型
- 弥漫型
- 混合型
有序列表:
- Stage1
- Stage2
- Stage3
- Stage4
Markdown 中,插入链接只需要使用 [显示文本] (链接地址) 语法,例:(简书首页)
简书首页
Markdown 中,插入图片只需要使用 ! [] (图片链接地址) 语法,[]中的文字会作为图片的标注显示。例:(简书首页截图)
(三) 引用
Markdown 中,在引用的文字前面加上 > 。
例:
用 Markdown 有如下好处:
兼顾了「什么人都能打开」和「样式」。Markdown 就是纯文本,就是 txt,所以什么人都能打开。而如上所述,你可以用它来标记文本的样式,而且语法非常简单。
由于是纯文本,Markdown 文稿也不会因为未来软件升级而产生不同版本之间的兼容问题,即,不会出现「我这篇稿子是用旧版 Word 写的,你用新版 Word 看可能格式会有点问题」的情况。
Markdown 转 HTML 非常方便。HTML 是整个万维网(web)的标记语言,但更重要的是,它也是目前主流电子书格式所用的标记语言。无论是 EPUB, mobi,还是 Kindle 用的专有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你写的是书,用 Markdown 标注格式之后,可以很方便地转为以上格式(当然这个转换工作不需要由你来做);如果你写的是单篇的文章(例如新闻报道或专栏),未来也不排除结集出书的可能。若采用 Markdown,对于日后的文件转换工作也大有裨益。
(四) 粗体和斜体
Markdown 的粗体和斜体,用两个 * 包含一段文本就是粗体的语法,用一个 * 包含一段文本就是斜体的语法。
例:粗体语法 斜体语法
(五) 代码引用
需要引用代码时,引用的语句只有一段,不分行,用 ` 将语句包起来。
如果引用的语句为多行,可以将```置于这段代码的首行和末行。
例:
单句代码:hello world!
tinyarray 安装方式:
if(!require(tinyarray))devtools::install_github("xjsun1221/tinyarray")
library(tinyarray)
(六) 表格
表格相关代码由|和-----组成,第二行必须为|---|格式,第二行的:代表字的位置左、中、右、对齐。
注:此处需要英文下输入。
例:
Markdown学习内容 | ||
---|---|---|
1.标题 | 2.列表 | 3.引用 |
1 | 2 | 3 |
---|---|---|
a | b | c |
(七)Markdown 段落
创建段落,使用空白行将一行或多行文本进行分隔。
不要用空格(spaces)或制表符( tabs)缩进段落。
(八)Markdown 换行
在一行的末尾添加两个或多个空格
然后按回车键,即可创建一个换行
(九)显示括号中带链接的图片
(十)R Markdown
R Markdown 为数据科学提供了一种写作框架,可以集成代码、输出结果和文本注释。R Markdown文档支持包括PDF、Word、幻灯片等多种输出格式。可供学习的材料有:
- R Markdown速查表: 在R Studio中,Help ---- Cheatsheets ---- R Markdown Cheat Sheet。
- R Markdown用户指南: 在R Studio中,Help ---- Cheatsheets ---- R Markdown Reference Guide。
参考资料:
《献给写作者的 Markdown 新手指南》
《为什么作家应该用 Markdown 保存自己的文稿》
《Markdown 基本语法| Markdown 官方教程》
《R数据科学》