洞洞! | 原喵空间

正文

【廿一】markdown简明教程(施工中)

作者:21hua

【廿一】markdown简明教程(施工中)

站内支持markdown语法编辑,用熟练的话排版会非常迅速非常漂亮,期待各位能贡献出更加优质的文章,廿一在此分享一些常用的语法,帮助大家快速学会markdown的基本使用。

Todo

  • 基础语法-标题 (03.22)
  • 基础语法-换行与段落(03.23)
  • 基础语法-粗体与斜体 (03.23)
  • 基础语法-分割线、删除线 (03.26)
  • 基础语法-链接与图片(03.30)
  • 基础语法-引用与代码引用
  • 基础语法-列表与表格
  • 基础语法-转义字符
  • 扩展语法-文字颜色
  • 扩展语法-注释
  • 扩展语法-任务列表

一、基本语法

1 基本语法-标题:

可以使用“#”符号来生成标题,一个“#”就是一级标题,两个就是二级标题,三个就是三级标题,以此类推

   示例
    # 一级标题
    ## 二级标题
    ### 三级标题

效果预览

一级标题

二级标题

三级标题

markdown原生语法还可以继续往下四级、五级标题,不过经测试,本站支持到三级标题,四级往后均为字体加粗(当然,三级标题写文章也很够用了)

tips: “#”与文字之间要有一个空格噢~

PS.标题语法扩展
相信有部分小伙伴已经注意到文章会把第一行的所有内容复制成标题,但如果在标题最前面出现一个“#”有时候会有碍观瞻,markdown有另一种标题语法可以解决这个问题,方法如下,在标题下一行输入3个等号“=”或者短划线“-”

示例
    一级标题
    ===
    二级标题
    ---

效果预览

一级标题

二级标题

  

2 基本语法-换行与段落

标题之后就要开始写文章了,文章分段换行在markdown的语法以及最后呈现的效果中有一定影响,用法很简单
使用回车键直接就可以换行,连续换两行(即两行之间有个空行)就是分段落。


示例

  这是第一段第一句。这是第一段第二句。这是第一段第三句。(第一行输入)
这是第一段第二行第一句。这是第一段第二行第二句。这是第一段第二行第三句。 //与上一行之间没有空行
//这里是空行
  这是第二段第一句。这是第二段第二句。这是第二段第三句。
//这里是空行
  这是第三段第一句。这是第三段第二句。这是第三段第三句。

效果展示(复制粘贴的话记得删掉注释文字“//这里是空行”,后续会提到如何注释)

  这是第一段第一句。这是第一段第二句。这是第一段第三句。(第一行输入)
这是第一段第二行第一句。这是第一段第二行第二句。这是第一段第二行第三句。

  这是第二段第一句。这是第二段第二句。这是第二段第三句。

  这是第三段第一句。这是第三段第二句。这是第三段第三句。

注意第一段落有两行,这个换行是使用enter回车键直接换行。并且在markdown语法中,两行文字中间不空行会被视为同一段落来处理。

空行和不空行的直接外在表现就是行距问题,如果两行之间不空行,行距大致为word里的1.5倍行距,两行之间空行则大致为2倍行距。

关于对段落的markdown的语法处理,目前比较明显的就是标题的使用,我们举例说明:


示例

这是个文章大标题
===
#### 这是作者信息

引言
引言第一句。引言第二句。引言第三句。引言第四句。引言第五句。引言第六句。引言第七句。引言第八句。引言第九句。引言第十句。引言第十一句。引言第十二句。
---

第一段
第一段第一句。第一段第二句。第一段第三句。第一段第四句。第一段第五句。第一段第六句。第一段第七句。第一段第八句。第一段第九句。第一段第十句。第一段第十一句。第一段第十二句。
---

效果展示

这是个文章大标题

这是作者信息

引言
引言第一句。引言第二句。引言第三句。引言第四句。引言第五句。引言第六句。引言第七句。引言第八句。引言第九句。引言第十句。引言第十一句。引言第十二句。

第一段
第一段第一句。第一段第二句。第一段第三句。第一段第四句。第一段第五句。第一段第六句。第一段第七句。第一段第八句。第一段第九句。第一段第十句。第一段第十一句。第一段第十二句。

可以看出来,使用“=”和“-”的标题语法会对整个段落生效。同时在本站时,第一行会被标记成对应级别标题的颜色。不考虑正文字体的话这个方法或许可以用来快速水文

  

3 基本语法-粗体与斜体

虽然前面已经有很邪道的粗体语法(四级标题以及“-”),但markdown是有非常好用好理解的粗体语法的。
在需要粗体的文字两端加上“**”两个星号就可以将文字转为粗体


示例

这是第一段文字,这里要**粗体**文字

**这第二段文字,本行粗体**
这是第二段文字,这一行不粗体

**这是第三段文字,全段粗体
这是第三段文字,全段粗体
这是第三段文字,全段粗体** 

效果展示

这是第一段文字,这里要粗体文字

这第二段文字,本行粗体
这是第二段文字,这一行不粗体

这是第三段文字,全段粗体
这是第三段文字,全段粗体
这是第三段文字,全段粗体

然后是斜体语法,在需要斜体的文字两端加“*”一个星号


示例

这是第一段文字,这里要*斜体*文字

*这是第二段文字,本行斜体*
这是第二段文字,这一行不斜体

*这是第三段文字,全段斜体
这是第三段文字,全段斜体
这是第三段文字,全段斜体*

效果展示

这是第一段文字,这里要斜体文字

这是第二段文字,本行斜体
这是第二段文字,这一行不斜体

这是第三段文字,全段斜体
这是第三段文字,全段斜体
这是第三段文字,全段斜体

有粗体有斜体,其实这两个还可以叠起来用,变成粗斜体,强调效果更好。
粗斜体语法是在文字两端加“***”三个星号


示例

这是第一段文字,这里要***粗斜体***文字

***这是第二段文字,本行粗斜体***
这是第二段文字,这一行不是粗斜体

***这是第三段文字,全段粗斜体
这是第三段文字,全段粗斜体
这是第三段文字,全段粗斜体***

效果展示

这是第一段文字,这里要粗斜体文字

这是第二段文字,本行粗斜体
这是第二段文字,这一行不是粗斜体

这是第三段文字,全段粗斜体
这是第三段文字,全段粗斜体
这是第三段文字,全段粗斜体


 

4 基本语法-分割线、删除线

分割线

分割线的语法非常简单,连续3个“-”或者“_”都可以


示例

---

___

效果展示



删除线

删除线的语法是在要划掉的文字两端各加一个“~”


示例

~这是一个删除线示例~

这是一个~删除线示例~

这是一个~删除线~示例

效果展示

这是一个删除线示例

这是一个删除线示例

这是一个删除线示例


 

5 基础语法-链接与图片

第一种其实在喵宅教程中有教到:

使用[这里是链接说明](链接地址)格式


示例

[点这里会链接到百度](www.baidu.com)

[点这里会链接到百度](www.baidu.com "可以打开试试看噢~")

效果展示

点这里会链接到百度

点这里会链接到百度


但会有意外情况,比如我想引用某个网站里的内容,网站的网址里面有空格,怎么办?

像这样

回复

0%
站点地图友情链接:
喵宅苑
喵空间社区程序
络合兔
技术宅
莉可POI
Mithril.js
枫の主题社
Project1
午后少年
机智库
七濑胡桃
xiuno
幻想の博客