原文链接
看过很多markdown的教程,要么废话太多泛泛而谈,要么粗略简要一带而过。如果你想做为手册查阅,或想了解简书Markdown使用的一些干货,那么这篇文章你不容错过。

一. Markdown是什么WHAT

程序员必备
Markdown是一种轻量级的「标记语言」

Markdown可以使用普通文本编辑器编写,通过简单的标记语法,它可以使普通文本内容具有一定的格式。它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面,Markdown文件的后缀名便是“.md”

二. 为什么选择 Markdown WHY
选择 Markdown 理由只有一个:方便,节省时间

☑ 语法简洁,没有任何编程基础的人10分钟语言即可上手
☑ 注重内容,专注于内容编写,不再因为格式排版而苦恼
☑ 易阅读性,即便没有经过转换,大部分内容仍可阅读
☑ 易编辑性,任何文本编辑器都能编辑 Markdown 文件
☑ 跨平台性,由于是纯文本文件,不存在格式兼容的问题
☑ 导出方便,支持导出为 HTML,PDF等常见格式

三. 如何使用 MarkdownHOW

  1. 标题:

Markdown支持6种级别的标题,对应html标签 h1 ~ h6

h1

h2

h3

h4

h5
h6
  1. 段落及区块引用:

这段文字将被高亮显示,多敲


可以换多个空行,输入多个> >>可以实现嵌套
这段文字将被高亮显示,多敲

可以换多个空行,输入多个>

可以实现嵌套

  1. 字体样式:

序号 源代码 效果
1 删除线 删除线
2 斜体字或_斜体字_ 斜体字
3 粗体 或__粗体__ 粗体
4 粗斜体 或___粗斜体___ 粗斜体
5 上标:O2 X2
6 下标:H2O H2O
7 字体颜色$\color{green}{绿色} $ \color{green}{绿色}
4. 图片和链接:

普通链接
普通链接

直接链接:https://www.jianshu.com/u/32ab4b968e34
直接链接:https://www.jianshu.com/u/32ab4b968e34

邮箱地址自动链接 nielifei.cn@gmail.com
邮箱地址自动链接 nielifei.cn@gmail.com

  1. 代码高亮:

行内高亮 : 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等

  1. 表格:
:在左靠左 :在两端居中 :在右靠右
A A A
B B B
C C C

:在左靠左 :在两端居中 :在右靠右
A A A
B B B
C C C
7. 无序列表:

*/-/+/>/#通用,后面跟空格即可,另外再输入1个TAB或2 ~ 4个空格可实现层级关系

  • 一级列表
    • 二级列表
      • 三级列表
        一级列表
        二级列表
        三级列表
  1. 有序列表:

注意数字后面有空格,序号递增排列,即便输错也会自动纠正

  1. 第一行
  2. 第二行
  3. 第三行
    第一行
    第二行
    第三行
  4. 分割线:

可以在一行中用 3 个以上的* 或 - 或 _来建立一个分隔线,行内不能有其他东西,为了兼容其他平台,可以在符号中间插入空格。




  1. 转义字符:
\
\>
\<br>

>
<br>
  1. 脚注:
    生成一个脚注[1].
    生成一个脚注[1].
  1. 特殊符号 文本通用,非MD独有:

常用排版 : ▌▍◆★☆☁➤➜❤➊➋➌
TodoList : ✅☑✓✔√☓☒✘ㄨ✕✖✗❌❎
emoji : 🌹🍀🌙🍂🍃🌷💎🔥⭐🍄🏆
更多的特殊符号就不一一列举了,想要了解更多打法的请查阅下面链接,也可以使用搜狗输入法:

HTML中的特殊符号
Emoji

  1. Markdown编辑器:

推荐一个好用的md编辑器typora


  1. 这里是 脚注内容. ↩︎