工具癖互联网旅行·在路上

你可能不知道的Markdown

2019-08-06  本文已影响286人  聂云⻜

看过很多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}{绿色} $ \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. 第三行
  1. 第一行
  2. 第二行
  3. 第三行

9. 分割线:

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

---
****
---



10. 转义字符:

\```
\>
\<br>

```
>
<br>

11. 脚注:

生成一个脚注[^footnote].
  [^footnote]: 这里是 **脚注** 的 *内容*.

生成一个脚注[1].

12. 特殊符号:

常用排版 : ▌▍◆★☆☁➤➜❤➊➋➌
TodoList : ✅☑✓✔√☓☒✘ㄨ✕✖✗❌❎
emoji : 🌹🍀🌙🍂🍃🌷💎🔥⭐🍄🏆

更多的特殊符号就不一一列举了,想要了解更多打法的请查阅下面链接,也可以使用搜狗输入法:

HTML中的特殊符号
Emoji

13. Markdown编辑器:

在线版,推荐和印象笔记结合的马克飞象

浏览器插件

客户端

比较遗憾的是,在简书的Markdown文本编辑器中,不支持注释、MathJax、 顺序图或流程图、任务列表(Task lists)等

另外要想使用简书,请在设置内将常用编辑器配置为Markdown


  1. 这里是 脚注内容.

上一篇 下一篇

猜你喜欢

热点阅读