美文网首页
Markdown语法很简单

Markdown语法很简单

作者: 布衣世佳 | 来源:发表于2018-08-13 15:24 被阅读0次

    本文首发于:https://qinshijia.github.io/2018/08/13/markdown-introduction/

    Markdown简介

    Markdown是一种轻量级的标记语言,目标是实现易读易写。

    简单的语法规则,漂亮的显示效果,容易读写随意改,是Markdown的特点。使用Markdown写作,能让您专注于内容,不需要浪费大量时间去排版。很多博客、在线笔记等工具都支持Markdown格式的文档,例如GitHub、Stack Overflow、简书、为知笔记。

    下面会介绍常用的Markdown语法。

    Markdown语法

    标题

    Markdown中标题分为六级,在行首以 # 开头并空一格再写标题文字。# 的个数标题的级数,一级标题字体最大,六级标题字体最小。

    # 这是一级标题
    ## 这是二级标题
    ### 这是三级标题
    #### 这是四级标题
    ##### 这是五级标题
    ###### 这是六级标题
    

    段落

    段落没有标记,段落的前后应该有一个以上空行。段落不推荐使用缩进。

    链接

    链接标记是一个中括号和一个小括号连在一块,中括号内是要链接的文字,小括号是链接地址,例如这样。链接可以是绝对地址,也可以是相对地址。

    [百度](https://www.baidu.com/)
    

    图片

    插入图片需要先保存好图片,然后再通过引入图片的方式显示。

    图片的标记是一个感叹号、中括号和小括号连在一起,中括号里是图片加载不出来时显示的文字,小括号里是图片的链接地址。

    下面这张图片的写法是:

    ![Markdown图标](https://img.haomeiwen.com/i13557430/772d6394ecaf885a.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
    
    Markdown图标

    段内代码

    段内代码标记是由两个 ` 符号(键盘上制表符上面,1旁边的按键)组成,两个`中间是要显示的代码,例如这样 Hello world!

    `Hello world!`
    

    代码块

    代码块是在开头和结尾都以三个连续的 ` 符号组成,中间为显示的代码。怎么没有行号?那是Markdown解析后前端显示的问题,不是语法的问题。

    String text = "Hello world!";
    System.out.print(text);
    

    引用

    在段落的开头使用 > 符号即可,显示的效果如下:

    这是一段引用

    > 这是一段引用
    

    无序序列

    无序序列在行开头使用 * 或者 - 或者 + 即可。显示效果如下

    • 无序序列
    • 无序序列
    • 无序序列
    * 无序序列
    - 无序序列
    + 无序序列
    

    有序序列

    有序列表则使用数字接着一个英文句点,数字的大小顺序对显示的结果没有影响,显示结果会按照行的顺序重新编号。

    1. 有序序列1
    2. 有序序列2
    3. 有序序列3
    1. 有序序列1
    1. 有序序列2
    1. 有序序列3
    

    表格

    表格是用符号 | 标记,在 | 之间的就是表格的内容。第一行是表头,第二行是控制表格显示方式,第三行以后是表格内容。

    靠左显示 居中显示 靠右显示
    第二行使用符号 :- 第二行使用符号 :-: 第二行使用符号 -:
    |靠左显示|居中显示|靠右显示|
    |:-|:-:|-:|
    |第二行使用符号 :-|第二行使用符号 :-:|第二行使用符号 -:|
    

    强调

    强调是在段内的 * 之间插入要强调的文字,一个*是斜体,连续两个 **是加粗,例如 我想倾斜一下我想加粗一下

    *我想倾斜一下*
    **我想加粗一下**
    

    Markdown工具推荐

    Markdown 语法已经足够简单了,使用常用的文本编辑器就能完成写作。随着 Markdown 越来越流行,配套工具也丰富了起来,语法高亮、实时预览、图片粘贴等功能也很吸引人。

    这里推荐一款文本编辑器 Atom,它着丰富的插件库,在 Atom 的 File -> settings -> install中搜索相应插件然后安装即可,使用方法在搜索结果界面点进去都有介绍。 Markdown 相关的插件有以下这些:

    • markdown-writer:语法高亮
    • markdown-scroll-sync:编写的时候按了 Ctrl + Shift + M,之后能同步滚动预览
    • markdown-image-assistant:截图之后直接按 Ctrl + V 粘贴

    其他工具可以看一下Markdown 在线编辑阅读器及应用收集

    参考文档

    Markdown 教程

    相关文章

      网友评论

          本文标题:Markdown语法很简单

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