Markdown语法笔记

写在前面:简书支持富文本编辑和Markdown编辑两种编辑方式,默认为富文本,修改为Markdown方式是在个人设置->基础设置里面,修改后新建的文章即为Markdown编辑方式了。另外,不同的Markdown编辑器和支持Markdown编辑的不同网站对Markdown语法的支持有差异,造成显示效果的差别,需要区别对待。

很久一起就听说过Markdown这一概念,但一直没有细究,只知道这是一个简单简洁且易用的博客编辑方式,如今Markdown运用越来越广泛,本人也开始使用这玩意儿,如前面所说,markdown简单,不需要理解,但是需要记忆,而好记性不如烂笔头,本文简单记录常用的Markdown标签,供随用随查。

大标题(一级标题)

大标题 文字下一行写一个至多个=

中标题(二级标题)

中标题 文字下一行写一个至多个-

以上大标题和中标题也可以表示为

大标题(一级标题)

中标题(二级标题)

# 大标题(一级标题)## 中标题(二级标题)。 注意#和文字之间有空格。增加#的个数可以减小字体,最多六个。

普通文本

直接输入就是普通文本。但是要注意普通文本之间换行不能直接回车一次,否则会变成空格。用<br>才能换行。如果回车两次,则换行加空一行。比如
此时换行了(不一定通用)。

单行文本和多行文本

开头一个`Tab`符可以让文本加背景,单行或者多行都是在每一行行首加一个`Tab`符,注意与上面的`普通文本`要回车两次。多行文本高亮可以在上方和下方各三个 ` 符

文本高亮

用两个 ` 符包围起来的文字显示为高亮,如:高亮文字,注意 ` 符是英文输入状态。

文字加超链接

英文输入中括号[]和小括号(),中括号是文字,小括号是链接地址,如 [我的博客](www.wangxingyu.com) 显示为我的博客。也可以加一个鼠标悬停在文字上面时显示文字提示,格式: [我的博客](www.wangxingyu.com "悬停显示的文字") ,注意链接和英文双引号之间有空格。

插入符号

圆点符

行首*号后面加一个空格再输入文字,注意*号在行首。另外横杠-也可以。格式: * 圆点符号 显示效果:

  • 圆点符号

二级圆点符和三级圆点符是在*号前加一个和两个Tab符,如:

  • 一级原点符号
    • 二级圆点符号
      • 三级圆点符号 (注意必须有一级才能有二级)

缩进

缩进格式,行首英文输入大于号>后直接加文字。几级缩进就加几个>。与下方的文字隔两个回车。一般一级缩进就够用了。

>一级缩进
>>二级缩进
>>>三级缩进

显示效果为

一级缩进

二级缩进

三级缩进

插入图片

英文输入感叹号!加中括号[]加小括号()。格式:
![](图片链接地址),比如
![Google logo,不要说你看不到](https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png) 显示效果为:

Google logo,不要说你看不到
Google logo,不要说你看不到


也可以添加鼠标悬停文字提示,格式:
![Google logo,不要说你看不到](https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png "鼠标悬停显示文字")
上面图片不具备点击进入新页面功能,同时还可以在图片上增加超链接,如:

[![Google logo,不要说你看不到](https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png "鼠标悬停显示文字")](http://www.google.com)
就是将图片视为普通文本,外面再套一层链接,此时图片可点击,还有鼠标悬停文字显示。显示效果为:

Google logo,不要说你看不到
Google logo,不要说你看不到

插入代码块,并区别不同语言高亮标识符。

在代码块的上一行行首和下一行行首写三个 ` 符,后面加语言名称,不要有空格,如:

public static void main(String[] args){} // Java注释

可以看到代码块增加背景高亮,区分标识符和注释。

文本粗体,斜体,删除线及组合

**粗体文本** __粗体文本2__ *斜体文本* _斜体文本2_ ~~删除线文本~~ **_粗体加斜体_**

粗体文本 粗体文本2 斜体文本 斜体文本2 删除线文本 粗体加斜体

表格

第一行文字粗体表示每列名称,在下方加至少3个横杠-符。用|分隔各列,不需要手动对齐。表格中的元素可以使用粗体、斜体、高亮等。如:

一行一列标题|一行二列标题|一行三列标题
---|---|---
二行一列|二行二列~|二行三列~
三行一列~|三行二列~~|三行三列~~
一行一列标题 一行二列标题 一行三列标题
二行一列 二行二列~ 二行三列~
三行一列~ 三行二列~~ 三行三列~~

使用反斜杠\可以对符号转义。

三个或以上下划线_或者中划线-可以画一条横线,但是中划线要注意与二级标题区分开。比如:
___ 显示为:


Github (GFM)

:sparkles: :camel: :boom: 等等表示各种小图标,只有在Github上才能显示效果。格式:两个冒号:之间加指令。

  • [x] 表示已完成的项目 格式: - [x] 注意横杠后有空格
  • [ ] 表示没有完成的项目 格式: - [ ] 注意中括号内有空格

本文写了好久,结果发现在不同的编辑器中显示效果还是有差异,因为Markdown并不是统一的标准,比如Github有自己的GFM,已完成和未完成项目以及Emoji在其他编辑器可能不能正常显示,所以还需要总结...


P.S. 本文同步自www.wangxingyu.com

推荐阅读更多精彩内容

  • 跳至内容 taolex客栈又一个WordPress站点 Markdown语法笔记 前言 这篇文章其实我之前就在Gi...
    zealous阅读 446评论 0 1
  • Markdown语法笔记 1.标题 一级标题 # 一级标题 二级标题 ## 二级标题 三级标题 ### 三级标题 ...
    zpeople阅读 291评论 1 0
  • Markdown 是一种轻量级的「标记语言」,它的优点很多,目前也被越来越多的写作爱好者,撰稿者广泛使用。看到这里...
    奋斗的蜗牛阅读 272评论 0 3
  • Markdown 是一种轻量级的「标记语言」,目前被越来越多的写作爱好者,撰稿者广泛使用。Markdown 的语法...
    松n_n鼠阅读 76评论 0 1
  • 朋友问我,如何控制每顿饭所需要的食材的量?因为她总是觉得菜太少了,没法做。而且剩菜又不喜欢吃。还想吃很多种类,好难...
    桃之虫二阅读 9,212评论 2 8
  • 【原创】.《春风似妖》 人间三月吹妖风 桃红柳绿闹争春 花香满园关不住 朵朵新蕊飘出来 @送给所有人! 推荐文章:...
    净心亭阅读 193评论 6 9
  • 如今,情人节已经脱离了原有的含义,成了一种表达大爱的仪式。让我们这些早已远离情海的边缘人也可以大大方方的和一群因为...
    元初阅读 77评论 0 0