Markdown 语法笔记

Markdown 语法笔记

写在前面

​  经过几乎一天的查找搜索,我粗略地整理了一下经常会用到的Markdown语法。其中的大部分内容来自网友大佬的博客、教程等等。发表这个笔记,一是为了自己可以有一个速查的手册,第二是测试目前简书对这些语法的支持,以便以后文章发表,同时第三也想拿出来与和我一样的初学者分享,并欢迎大佬斧正与补充。
  我线下使用的编辑器是typora,好用不多介绍;这文放到简书上面目全非,有些地方只能用图片,有的直接就放弃了,可能简书就是要“简”吧,专治各种花里胡哨(ಡωಡ)。

目录

(看来这个不行,上图)


编辑器上是这样

1.字体

加粗

**加粗**

斜体

*斜体*

斜体加粗

***斜体加粗***

<u>下划线</u>

<u>下划线</u>

删除线

~~删除线~~

上标2

上标<sup2</sup>

下标2

下标<sub>2</sub>

设置字体、字号、颜色

好像不支持html


<font face="STCAIYUN">华文彩云</font>

<font color=gray size=5>color=gray</font>

<font color=#0099ff size=5 face="黑体">color=#0099ff size=5 face="黑体"</font>

背景色

<table><tr><td bgcolor=#D1EEEE>背景色的设置是按照十六进制颜色值:#D1EEEE</td></tr></table>

2.样式

标题

标题有6个等级,用 # 号表示

#为一级标题 ######为六级标题

另一种形式是使用=(一级)和-(二级)三个以上

主标题

副标题

主标题
======
副标题
-----

引用

引用内容1
引用内容2

子引用内容

用>表示引用,多个>连用分级

代码(块)

``中间放代码内容

System.out.println("Hellow World");

用``````表示下面的是一段代码

注意每个```独占一行,第一个```后给出代码语言可以实现代码高亮

​```c++
#include <iostream>
int main()
{
    std::cout << "Hellow World!" << std::endl;
    return 0;
}
​```

效果:

#include <iostream>
int main()
{
    std::cout << "Hellow World!" << std::endl;
    return 0;
}

任务

- [ ] 任务1
- [ ] 任务2
  - [×] 子任务
- [ ] 任务3

列表

有序列表

使用数字加小数点标记,可以有子列表。三代可区分。

  1. 有序1
  2. 有序2
    1. 子有序1
    2. 子有序2

无序列表

无序列表使用星号*,加号+,减号-作为标记,加空格加内容即可。

  • 列表1
  • 列表2
    • 子列表

注释

()

(<!--注释内容不会在浏览器中显示-->)

字符转义

反斜线(\)用于插入在 Markdown 语法中有特殊作用的字符。

包括:

\
`
*
_
{}
[]
()
#
+
-
.
!

用法:\字符 即可

**演示** (\*\*演示\*\*)

↓对比↓

演示**演示**

3.插入

表格

typora有方便的表格插入及格式编辑

项目 项目1 项目2
内容 内容 内容
内容 内容 内容

表格可以自适应内容长度

|、-、:之间的多余空格会被忽略

对齐方式:

默认标题栏居中对齐,内容居左对齐。
需要自定义时-:表示内容和标题栏居右对齐,:-表示内容和标题栏居左对齐,:-:表示内容和标题栏居中对齐,-至少有一个。
每行第一个|和最后一个|可以省略。

图像

基本支持常见的图像格式

插入

[图片上传失败...(image-e34290-1550671755184)]

插入三种方式——本地图片,网络图片,把图片编进Markdown

简书自带上传图片功能,因此不多废话。

![苹果](http://upload-images.jianshu.io/upload_images/16367356-bbafb43be3a9b4c4.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

苹果

(图片来源于百度)

以下对图片的操作都无法显示,不再一一截图,但是应该都可以在编辑器上实现。

修改图片大小

方法一 使用html代码

<img src ="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" height="500px" width="500px" >

width 与 height 没有顺序要求,=数字可加单位(px-像素,cm-厘米,mm-毫米)。

width和height只写其中一个按原图比例修改另一个。
效果:
(此处应有图片)

方法二 使用支持图片大小更改操作的 Mou 编辑器
使用如下语法
[图片上传失败...(image-b5c184-1550671755184)]

试了试好像不支持,先放上面。

注意: =前有个空格,可以只写宽度。

缩放

<img src ="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" width=50%>

这个好像只能按照width,以原图比例缩放,不知道其他编辑器怎么样。
效果:
(此处应有图片)

对齐方式

一张图片

<img src ="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" width=50% align="right">

(我也没有成功。。。)

图片组

<div align="center">
<img src="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" width="15%" >
<img src="https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1550479777845&di=a08531ffcf1280e835e8841e3233b17a&imgtype=0&src=http%3A%2F%2Fpic.qjimage.com%2Feast019%2Fhigh%2Feast-ep-a61-6252755.jpg" width="15%" >
</div>

效果:
(此处应有图片)

超链接

行内式

[**简书-创作你的创作**](https://www.jianshu.com/)

简书-创作你的创作

包含'title'的链接

[**简书-创作你的创作**](https://www.jianshu.com/ "简书官网")

简书-创作你的创作

也可以用于链接本地文件

参考式

分为两部分

[链接文字][识别符]
[识别符]:URL "title"

第一行定义链接,第二行定义链接内容。识别符可以不写,用链接文本代替,URL可以使用<>括起来,title可以用"" ''()包括。链接内容的定义可以放在文档的任意地方,因此,参考式可以多次引用同一个链接,避免频繁定义。

简书

链接的自动转换

使用<>括起来的URL或者邮箱地址会自动转换为超链接

<https://www.jianshu.com/>

https://www.jianshu.com/

<123456789@email.com>

123456789@email.com

该方式适合行内较短的链接,会使用 URL 作为链接文字。邮箱地址会自动编码,以逃避抓取机器人。

水平线

可以在一行中使用三个或更多的 *-_ 来添加分隔线(<hr>

***
-------
_____

字符之间可以有空格但不能有其他字符。

脚注[1]

一般用法:

文字[^脚注id]文字
[^脚注id]:脚注内容。

注意:

脚注id请保持唯一性,引用和内容的id需要一一对应

如果只有底部脚注正文而文章中没有引用,此条脚注将被隐藏
如果只有文中引用没有底部对应脚注,一条新的脚注将添加到脚注列表末尾,且以引用标记的脚注id为内容
引用标记的脚注id,支持数字字母和空格
脚注内容支持 titile 属性,但 title 加在引用标记上

目录

[TOC]

效果就是本篇目录

4.段落

这个可能因为编辑器不同而有不一样的方法。

一个段文本如果前后一行都是空行(没有字符,或只有空格和制表符),那么它是一个段落。

换行

有时后需要另起一行而不是新加一段。

typora貌似可以shift+enter换行
后面的内容

也可以加<br>
后面的内容

可以在前一行的末尾加入至少两个空格
然后换行写其它的文字

缩进

使用特殊的占位符

【1】 &ensp;或&#8194; //半角空格
【2】 &emsp;或&#8195; //全角空格
【3】 &nbsp;或&#160; //半角的不断行的空白格

从&到;一个字符都不能少

 段落1【1】

 段落2【2】

 段落3【3】

对照段落

全角的状态下双击两次空格

切换到全角模式下输入两个空格就行了。搜狗输入法需要右键打开,或者在属性设置->高级->快捷键中开启全半角切换快捷键(shift+空格)

对齐

Markdown基本不支持排版。
可以使用html语言实现(可能有不同版本,简书不支持)

<center>居中</center>
<p align="left">居左</p>
<p align="right">居右</p>


  1. 脚注不是标准Markdown的内容。可能会有不同的定义方式。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 195,898评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,401评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 143,058评论 0 325
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,539评论 1 267
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,382评论 5 358
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,319评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,706评论 3 386
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,370评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,664评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,715评论 2 312
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,476评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,326评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,730评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,003评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,275评论 1 251
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,683评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,877评论 2 335

推荐阅读更多精彩内容

  • 跳至内容 taolex客栈又一个WordPress站点 Markdown语法笔记 前言 这篇文章其实我之前就在Gi...
    zealous阅读 791评论 0 1
  • 为什么学习Markdown 自从搭建了 Hexo 博客之后,发现还有 Markdown 这种写文章的方法,想到以后...
    lifeColder阅读 20,094评论 10 216
  • Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里...
    奋斗的蜗牛阅读 510评论 0 3
  • [TOC] Markdown: 是一种电子邮件风格的标记语言,通常为程序员群体所使用。同时,Markdown支...
    _Rambo_阅读 1,124评论 0 5
  • 有一些对象其实我们只需要一个,比如线程池、缓存、对话框、日志对象等,于是单例模式就出场了。 饿汉式 饿汉式是最简单...
    许方镇阅读 285评论 0 0