看着比较好 最近需要学习一下 感觉这个写的比较详细 引用学习一下
Markdown常用基础语法
先想想我们一般写作时候需要用到什么样的排版?
无非就是标题、引用、强调(加粗、斜体、下划线)、插入链接、插入图片、列表(有序和无序列表),甚至连表格都很少用。
标题语法
Markdown一共支持6个级别大小的标题(对应于HTML语法里的h1~h6),写法很简单,就是在文字前空一格加上#号就行,几个#号就是几级标题,大小由大到小。
第一级标题 <h1>
第二级标题 <h2>
第六级标题 <h6>
效果如下:
第一级标题
第二级标题
第六级标题
引用语法
如果你想引用一段文字,那就使用大于号>
这是一段引用
这是另一段引用
效果如下:
这是一段引用
这是另一段引用
强调语法
粗体
如果你想加粗一段文字,只需要在文字前后加两个*号
我很重要!
效果如下:
我很重要哦!
斜体
如果你想让一段文字倾斜,只需要在文字前后加一个星号*
我是比萨斜塔
效果如下:
我是比萨斜塔
下划线
如果你想让一段文字加上下划线,只需要在文字前后加一个下划线_
人是社会性动物
效果如下:
人是社会性动物
删除线
如果你想让一段文字加上删除线效果,只需要在文字前后加一个波浪线~
我所说的都是错的
效果如下:
我所说的都是错的
插入链接
如果你想把一段文字加上链接指向到某个网址,就把文字用中括号围起来[],然后加上一个小括号(),括号里填上网址即可。
插入图片
插入图片的语法和插入链接很像,就是在前面加了一个叹号!,注意:叹号是英文叹号。
效果如下:
列表
列表分为有序列表和无序列表,什么是有序列表呢?就是1、2、3顺序排开。
有序列表
语法如下,注意:数字后加点. 再空一格写内容。
-
把冰箱门打开
-
把大象放进去
-
关上冰箱门
效果如下:
把冰箱门打开
把大象放进去
关上冰箱门
无序列表
无序列表只需要在文字前面加上减号-就行。(星号*或加号+也可以,看个人喜好,我比较喜欢用减号)
-
把冰箱门打开
-
把大象放进去
-
关上冰箱门
效果如下:
把冰箱门打开
把大象放进去
关上冰箱门
其他标记
换行
当你写大段文本分段的时候,只是回车换行是不行的,有些解释器出来的效果会让文字连在一起。
段落与段落之间需要强制空一行才能分段。
分割线
你可以在一行中使用三个以上的星号*或减号-来创建分割线(注意:行内不能有其他东西)
效果如下:
Markdown高级语法
还有一些不太常用的语法,比如插入代码区块、插入表格等等。
代码区块
如果你是一个程序员,需要分享自己的代码,那就需要创建代码区块,如果像普通的段落一样显示,格式可能会很糟糕。
当然,把整块文本放区块里也很常见,比如本文的语法解释部分。
语法:需要整体内容缩进 4 个空格或是 1 个制表符(tab)
var Promise = require(‘bluebird’);
var request = Promise.promisify(require(‘request’));
var fs = require(‘fs’);
var cheerio = require(‘cheerio’);
var s = require(“underscore.string”);
或者使用另外一种写法,就是在代码前后位置加上三个反引号`(数字键盘1左边那个按键)
如果是行内代码引用的话,只需要在代码前后加上一个反引号`。
Use the whoisyourdaddy()
function.
效果如下:
Use the whoisyourdaddy() function.
插入表格
Markdown插入表格的语法相对复杂,必须要按格式来敲,注意表头与内容的分割线横线-不能少于3个。
第一格表头 | 第二格表头
— | —
内容单元格 第一列第一格 | 内容单元格第二列第一格
内容单元格 第一列第二格 多加文字 | 内容单元格第二列第二格
效果如下:
以上都是相对基础的Markdown语法,想深入了解的看:
Markdown语法中文介绍完整版
根据Markdown解释器的不同,有些甚至还会支持更多高级语法,比如流程图、Todolist、MathJax公式等等。
Markdown解析器最终会把你的文档解析成HTML格式,所以Markdown语法也原生支持HTML语法,想学HTML的看这个:W3C HTML教程