看过很多markdown的教程,要么废话太多泛泛而谈,要么粗略简要一带而过。如果你想做为手册查阅,或想了解简书Markdown使用的一些干货,那么这篇文章你不容错过。
一. Markdown是什么WHAT
程序员必备
Markdown是一种轻量级的「标记语言」
Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面,Markdown文件的后缀名便是“.md”
二. 为什么选择 Markdown WHY
选择 Markdown 理由只有一个:方便,节省时间
☑ 语法简洁,没有任何编程基础的人十几分钟语言即可入门
☑ 注重内容,专注于内容编写,不再因为格式拍版而苦恼
☑ 易阅读性,即便没有经过转换,大部分内容仍可阅读
☑ 易编辑性,任何文本编辑器都能编辑 Markdown 文件
☑ 跨平台性,由于是纯文本文件,不存在格式兼容的问题
☑ 导出方便,支持导出为 HTML,PDF等常见格式(需要工具支持)
三. 如何使用 MarkdownHOW
1. 标题:
Markdown支持6种级别的标题,对应html标签 h1 ~ h6
# h1
## h2
### h3
#### h4
##### h5
###### h6
2. 段落及区块引用:
> 这段文字将被高亮显示,多敲<br/><br/><br/>可以换多个空行,输入多个\> >>可以实现嵌套
这段文字将被高亮显示,多敲
可以换多个空行,输入多个>可以实现嵌套
3. 字体样式:
序号 | 源代码 | 效果 |
---|---|---|
1 | ~~删除线~~ |
|
2 |
*斜体字* 或_斜体字_
|
斜体字 |
3 |
**粗体** 或__粗体__
|
粗体 |
4 |
***粗斜体*** 或___粗斜体___
|
粗斜体 |
5 | 上标:O<sup>2</sup>
|
X2 |
6 | 下标:H<sub>2</sub>O
|
H2O |
7 | 字体颜色$\color{green}{绿色} $
|
4. 图片和链接:
[普通链接](https://www.jianshu.com/u/32ab4b968e34)
直接链接:<https://www.jianshu.com/u/32ab4b968e34>
直接链接:https://www.jianshu.com/u/32ab4b968e34
邮箱地址自动链接 nielifei.cn@gmail.com
邮箱地址自动链接 nielifei.cn@gmail.com
![图片链接,可以添加备注](https://img.haomeiwen.com/i3668672/847b228d15e1e9d1.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "markdown")
图片链接,可以添加备注
5. 代码高亮:
行内高亮 : `npm install marked`
行内高亮 :npm install marked
实现代码块适配合适的高亮方法,可以用 ``` 包裹一段代码,并指定一种语言。
```javascript
function test() {
console.log("后面跟语言有一定效果");
}
```
function test() {
console.log("后面跟语言有一定效果!");
}
支持的语言: bash, basic,cmake, css, delphi, django, dockerfile, go, http,,ini, java, javascript, json, leaf, less, matlab, perl, php, python, ruby, rust, scss, sql, stylus, swift, typescript, vbscript, xml, yaml等
6. 表格:
|:在左靠左 |:在两端居中|:在右靠右|
|:--|:--:|--:|
| A | A | A |
| B | B | B |
| C | C | C |
:在左靠左 | :在两端居中 | :在右靠右 |
---|---|---|
A | A | A |
B |
B | B |
C | C | C |
7. 无序列表:
*/-/+/>/#通用,后面跟空格即可,另外再输入1个TAB或2 ~ 4个空格可实现层级关系
+ 一级列表
+ 二级列表
+ 三级列表
- 一级列表
- 二级列表
- 三级列表
- 二级列表
8. 有序列表:
注意数字后面有空格,序号递增排列,即便输错也会自动纠正
1. 第一行
2. 第二行
5. 第三行
- 第一行
- 第二行
- 第三行
9. 分割线:
可以在一行中用 3 个以上的* 或 - 或 _来建立一个分隔线,行内不能有其他东西,为了兼容其他平台,可以在符号中间插入空格。
---
****
---
10. 转义字符:
\```
\>
\<br>
```
>
<br>
11. 脚注:
生成一个脚注[^footnote].
[^footnote]: 这里是 **脚注** 的 *内容*.
生成一个脚注[1].
12. 特殊符号:
常用排版 : ▌▍◆★☆☁➤➜❤➊➋➌
TodoList : ✅☑✓✔√☓☒✘ㄨ✕✖✗❌❎
emoji : 🌹🍀🌙🍂🍃🌷💎🔥⭐🍄🏆
更多的特殊符号就不一一列举了,想要了解更多打法的请查阅下面链接,也可以使用搜狗输入法:
13. Markdown编辑器:
在线版,推荐和印象笔记结合的马克飞象
浏览器插件:
客户端:
- Mac:MacDown
- Windows:MarkdownPad、MarkPad
比较遗憾的是,在简书的Markdown文本编辑器中,不支持注释、MathJax、 顺序图或流程图、任务列表(Task lists)等
另外要想使用简书,请在设置内将常用编辑器配置为Markdown
-
这里是 脚注 的 内容. ↩
网友评论