Markdown语法收集整理

最新推荐文章于 2024-07-29 23:56:34 发布

白於青

最新推荐文章于 2024-07-29 23:56:34 发布

阅读量385

点赞数

CC 4.0 BY-SA版权

分类专栏：标记语言文章标签： markdown 编辑器

本文链接：https://blog.youkuaiyun.com/lfz_1912/article/details/70174755

标记语言专栏收录该内容

1 篇文章

订阅专栏

本文详细介绍Markdown语法的各项功能，包括换行、缩进、标题、列表、引用、删除线、链接、图片、表格、代码块及分割线的创建方法。适合Sublime编辑器使用，遵循GitHub规范。

# Markdown语法收集整理 **本文适用于sublime中的markdown语法，符合github语法规范，因为不同的平台往往存在细微差异，本文内容可能不完全适用其他环境。** ### 换行换行并不能通过单纯使用回车键完成，规范的语法是“空格+空格+回车”。 ### 首行缩进当我们新起一行，输入四个空格以图达到首行缩进的排版效果时，你会发现：不行，输入的文字被当作代码给标记起来了。肿么办？很简单，在段首加入“&”+“ensp;”来输入一个空格，输入“&”+“emsp;”来代替两个空格（一个汉字宽度）。 ### 标题的生成标题之前以符号“#”开头，且符号#与正式的标题之间最好加入一个空格（此为规范语法）。标题共有六个等级，随着“#”的个数从一到六分别为一到六级，字号渐小。此外，在文字的下一行输入两个以上的减号或者等号，也会生成标题，这两种方法生成的标题等级不同。 ### 列表的生成列表分为有序列表和无序列表，前者以有序的阿拉伯数字开头，数字后接符号“.”，后接一空格；后者可以用符号“*”、“+”、“-”开头，并接一空格，且三者可以混用。在次一行缩进四个字符，可以产生次一级的列表。列表的前后都要有空行。示例： \+ 亚洲 1\. 中国 - 山东 - 江苏 - 河南 \+ 欧洲 \* 德国 \* 法国效果如下： + 亚洲 1. 中国 - 山东 - 江苏 - 河南 2. 日本 3. 韩国 + 欧洲 * 德国 * 法国如果你在正文中恰好出现数字加点这种形式，但是并不想形成列表，那么可以在‘.’的前面加上‘\’来避免出现有序列表。**注意，符号\\是转义字符，可以帮过你输入原意字符，其作用不限于此处。** 此外，有序列表和无序列表似乎还可以混用，这样可以方便很多。但是，最好不要这么做，因为在其他平台中可能会出现与此处不同的情况，从而产生混乱。 1\. 十年生聚 2\. 十年教训 \- 有志者事竟成百二秦关终属楚 \+ 苦心人天不负三千越甲可吞吴上述例子效果如下： 1. 十年生聚 2. 十年教训 - 有志者事竟成百二秦关终属楚 + 苦心人天不负三千越甲可吞吴 ### 引用的格式很简单，用符号“>”开头就可以了。通过增加大于号的数量，可以生成多级引用。栗子： \>初唐诗 \>>陈子昂 \>>>前无古人，后来者，念天地之悠悠，独怆然而涕下。效果： >初唐诗 >>陈子昂 >>>前无古人，后来者，念天地之悠悠，独怆然而涕下。 ### 删除线这是GFM所增加的语法，前后各使用一对“~”直接包住的文字会被化掉。效果就像这样：~~删除线~~。 ### 链接的生成 Markdown支持两种链接：行内式和参考式。格式均为\[]()，不过行内链接的小括号是紧接在中括号之后的，中括号中放置链接的名称，小括号中放置链接地址，且小括号中加入双引号还可以为链接加上标题文字。举个栗子：如果我这样写：\[知乎](http://www.zhihu.com”行内链接”)，你看到的就是： [知乎](http://www.zhihu.com”行内链接”)。参考式的链接是在链接文字的中括号后面再接上另一个中括号，而在第二个中括号里面要填入用以辨识链接的标记，也可以空出来不写字，在文件的任意位置，把这个标记的链接内容写出来。 \[豆瓣]\[link_douban]是一个挺不错的网站（这是一个栗子）： [豆瓣] [link_douban]是一个挺不错的网站，评分的理由大多挺骚气的，我喜欢。本节最后会给出网址。这样一篇文章中引入的网址很多时可以得到统一管理，行文时也不会显得混乱。至于给出网址的方式，有两种（取决于你是否在第二个中括号里面填入内容。\[优快云][]是另外一个例子，当我这样写，你同样会看到这样的效果：[优快云][]。现在给出上述豆瓣网和优快云的链接给出的方式： \[link_douban]:http://www.douban.com \[优快云]:http://www.csdn.com”参考式” ### 图片的引入类似于链接的生成，图片也可以分为行内式和参考式，行内式的图片的引入格式为![\]()：感叹号之后接一中括号，其中写入图片的替代文字，之后是小括号，其中写入图片的地址，最后还可以用引号包住并加上选择性的标题文字：示例：![苏州]\(http://i4.buimg.com/567571/f97dda09a0809abe.jpg) ![苏州](http://i4.buimg.com/567571/f97dda09a0809abe.jpg) 至于图片的地址，可以登陆[极简图床网](http://yotuku.cn/)，上传本地图片并获取地址。 ![杭州][hangzhou] ![杭州]\[hangzhou] 是使用参考式引入的另外一张图片，它的链接是这样给出的： \[hangzhou]:http://i4.buimg.com/567571/0f776055c6741bd7.jpg 如此放置的图片，其位置和大小都是默认的，我们还可以通过下面这种方法规定其大小和位置。align规定了图片的位置，alt是图片的名称。

<div align=center>
    <img src="http://i1.piimg.com/567571/3b6645fcd6b80d97.jpg" width="600" height="435" alt="绝代芳华"/>
</div>

粗体与斜体

前后分别用两个“*”包住的文本将会是粗体，前后各只用一个“*”包住的部分将会是斜体。辣么，问题来了，如果说用三个“*”嘞？你猜……

表格的生成

大量使用符号“|”去模拟表格的形状，可以说是在“假装自己是一个表格”！燃鹅，它还真特么成了一个表格，你说它搞不搞笑……其中第二行中的冒号的放置决定了该栏内容的重心（左对齐、右对齐或者居中），默认左对齐。
栗子来啦：
| 姓名 | 年龄 | 性别 |
| ——- | ——-: | :——-: |
| 张三 | 20 | 男 |
| 李四 | 22 | 男 |
| 王五 | 24 | 男 |
| 赵美丽 | 18 | 女 |

姓名	年龄	性别
张三	20	男
李四	22	男
王五	24	男
赵美丽	18	女

代码的嵌入

如果你缩进4个空格或1个制表符然后输入文本，将会被视为代码，代码区块会一直持续到没有缩进的一行。我觉得更加方便的办法是在代码区的开头和结尾各加入三个反引号“···”，按键就在“Esc”的下面，因为有时候缩进会变得有点烦(还有人会为了到底要使用空格键还是制表符展开争吵，为了世界和平，我们就不要那样做了……)。如果你只想在行内插入少少的一点代码，可以只是用一个反引号，比如这样：`void funtion()`，效果是这样的void funtion(),也还不错。

添加四个空格后是这样的：

public class ActivityCollector {
  public static List<Activity> activities = new ArrayList<>();

        public static void addActivity(Activity activity){
    activities.add(activity);
        }

    public static void removeActivity(Activity activity){
          activities.remove(activity);
    }

    public static void finishAll(){
            for (Activity activity : activities){
                    if (!activity.isFinishing()){
                            activity.finish();
                    }
            }
    }
}

再使用三个反引号加一段代码试试：

“`
protected void onResume(){
super.onResume();
IntentFilter intentFilter = new IntentFilter();
intentFilter.addAction(“com.example.liu.broadcastbestpractice.FORCE_OFFLINE”);
receiver = new ForceOfflineReceiver();
registerReceiver(receiver, intentFilter);
}
“`
上述代码的效果是酱紫哒：

    protected void onResume(){
        super.onResume();
        IntentFilter intentFilter = new IntentFilter();
        intentFilter.addAction("com.example.liu.broadcastbestpractice.FORCE_OFFLINE");
        receiver = new ForceOfflineReceiver();
        registerReceiver(receiver, intentFilter);
    }