你可能不知道的Markdown

作者: 聂云⻜ | 来源:发表于2019-08-06 21:20 被阅读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. 这里是 脚注内容.

相关文章

  • 你可能不知道的Markdown

    看过很多markdown的教程,要么废话太多泛泛而谈,要么粗略简要一带而过。如果你想做为手册查阅,或想了解简书Ma...

  • Markdown | 你可能不知道的写作神器

    技术文档/文章的价值在于提供令人愉悦的信息体验。 这句话是大学毕业初入职场时,部门领导在新员工培训时说的,我一直深...

  • 你可能不知道的 Markdown 骚操作

    前言 Markdown 是我们广大程序员最熟悉的一门语言之一,因为它易读,语义化等特点,被我们广泛用于文档编写中,...

  • 使用Sublime来写MarkDown

    MarkDown 如果你现在还不知道MarkDown是什么的话,你就Out了。作为一个程序员,MarkDown已经...

  • 每个喜欢码字的人都应该学会使用markdown

    你可能还不知道markdown究竟是什么东西,不过我很确信,只要你喜欢码字,你就非常有必要学会它。 你可能是程序员...

  • Markdown测试

    此文档在更新时可能会被覆盖或删除 在使用Markdown之前,你可能需要先了解一下关于markdown的简单语法。...

  • 示例文档MD

    此文档在更新时可能会被覆盖或删除 在使用Markdown之前,你可能需要先了解一下关于markdown的简单语法。...

  • Markdown语法汇总

    Markdown语法汇总 前言 我们在平时写作的时候,可能你会倾向于使用 Markdown 这种富文本标记语言,因...

  • MarkDown使用教程

    在使用Markdown之前,你可能需要先了解一下关于markdown的简单语法。 1.标题 使用 # 表示标题,一...

  • 测试简书

    #### 不知道支持不支持markdown #### 不知道支持不支持vi #### 如果不支持markdown,...

网友评论

    本文标题:你可能不知道的Markdown

    本文链接:https://www.haomeiwen.com/subject/tskgdctx.html