你可能不知道的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

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