阅读指引
本文综合博主学习使用MarkDown的经验,对MarkDown做一个系统性介绍。
(重要信息会加粗,以节约阅读者时间)
阅读本文能给你带来什么:
- 明白MarkDown是什么
- 优点
- 缺点
- 什么时候适合使用MarkDown
- 如何使用
MarkDown是什么
Markdown是由约翰·格鲁伯(John Gruber)和亚伦·斯沃茨(Aaron Swartz)发明的一种轻量级的「标记语言」。使用这种标记语言撰写的文本,能被转换为HTML在Web上发布,并以结构化的效果展现。
Markdown 的目标是实现「易读易写」。
优点
Markdown把作者从繁杂的排版工作中解放出来,实现易读易写的文章写作,已经逐渐成为事实上的行业标准。
- 语法简洁明了、学习容易
- 使用极其简单,文档快速排版
缺点
- 复杂格式支持不完善
- 有多家扩展语法,扩展语法相互兼容并不友好
- 不同编辑器渲染结果有较大差异
什么时候适合使用MarkDown
博主个人经验总结建议:
建议使用:编辑纯文本内容时使用(可包含超链接,不包含图表)
不建议使用:当排版复杂、精细,对于缩进,间距等展示有较高要求,包含图表内容等情形
使用场景总结:纯文本、排版简洁、无复杂排版要求
如何使用
使用编辑器写作过程中,直接使用其语法既可
纯文本编辑器:可直接编辑,但无法直接查看渲染结果
MarkDown编辑器:MarkDown编辑器一般支持实时编辑,实时显示渲染结果
windows平台推荐:MarkdownPad
mac平台推荐:MacDown
其他编辑器:笔记类软件、在线博客平台
基本语法介绍
标题
在 标题下 加上任意个=代表一级标题,-代表二级标题
一级标题
======
二级标题
----------
在 标题开头 加上1~6个#,依次代表一级标题、二级标题....六级标题
# 一级标题
## 二级标题
### 三级标题
##### 四级标题
###### 五级标题
###### 六级标题
列表
无序列表使用-、+和*作为列表标记
- first
- second
- three
* first
* second
* three
+ first
+ second
+ three
有序列表使用数字加英文句点.来表示
1. first
2. second
3. three
强调(粗体、斜体、删除)
两个*或-代表加粗,一个*或-代表斜体,~~代表删除
**加粗文本** 或者 __加粗文本__
*斜体文本* 或者_斜体文本_
~~删除文本~~
换行(直接Enter不会换行)
在行尾添加两个空格+回车表示换行
分隔线
在一行中用三个以上的*、-、_来建立一个分隔线,行内不能有其他东西
***
---
___
代码
行内代码使用 `代码` 标识,可嵌入文字中
这是行内代码`onCreate`的例子
代码块使用4个空格或```标识
```
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
```
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
图片与链接
图片:![]() ![图片文本(可忽略)](图片地址)
链接:[]() [链接文本](链接地址)
其他
其他语法请参考
https://www.markdownguide.org/
本文参考
https://www.imooc.com/article/12063
https://blog.csdn.net/youmingyu/article/details/53101627
https://baike.baidu.com/item/markdown/3245829?fr=aladdin
http://www.markdown.cn/
https://www.markdownguide.org/
https://edu.csdn.net/course/detail/553
https://blog.csdn.net/u014745297/article/details/71629735?utm_source=itdadao&utm_medium=referral
https://www.jianshu.com/p/82e730892d42