博客列表 >Markdown语法使用和个人总结

Markdown语法使用和个人总结

吾逍遥
吾逍遥原创
2021年12月28日 09:22:571084浏览

一. Html与Markdown

  • Html是超文本标记语言,目前Html5是主流标准。
  • Markdown是超轻量级标记语言,它是完全支持Html语法,可以直接使用html标签。
  • Markdown是主要用于写文档,默认的Markdown语法写出来的文档效果还不是很丰富,所以有的Markdown编辑器对其进行扩展,使其支持公式、视频等。当然我们也可以自己使用html标签达到同样效果。

二. Markdown语法演示和注意事项

1. 标题

语法 #+空格+标题内容

  • 在行首插入 # 才有效
  • # 个数表示标题的等级,有1-6级标题,对应html中h1-h6
  • 注意事项:# 和标题内容之间一定有空格,空格至少一个,否则当成普通文本

源码

  1. # 一级标题
  2. ## 二级标题
  3. ### 三级标题

效果

一级标题

二级标题

三级标题


2. 分割线

语法 ---

  • 在行首插入 - 才有效
  • - 个数不能少于3个,一般与上一行文字长度对齐,这样Markdown文档显得好看
  • 注意事项:—- 和上一行建议 至少隔一行 ,若上一行是普通文本,下一行是分割线则翻译成 二级标题

源码

  1. 分割线
  2. -----
  3. 分割线
  4. -----

效果

分割线

分割线


注意 上面分割线与普通文本之间 隔行和没隔行 的区别


3. 列表

语法

  • 在行首写才有效
  • 有序列表: 1.+空格+内容,2.+空格+内容,…。注意 数字后而只能是点,不能是顿号。
  • 无序列表: -/+/*+空格+内容,无序列表符号有3个,任意一个都可以
  • 下一级: 无序列表 要在前面加上2个空格,若是在引用块中则要4个空格。有序列表 要用另一种计数方式
  • 有序列表序号: 若是0.则表示从上行自动计算,若是小于或等于上一行也自动计算

源码

  1. 1. 前端部分
  2. (1). html
  3. (2). css
  4. 2. PHP编程
  5. 2-1. 基础语法
  6. 2-2. 全局变量
  7. 0. 综合实战
  8. -------------
  9. - 前端部分
  10. - html
  11. - css
  12. - PHP编程
  13. + 基础语法
  14. + 全局变量
  15. - 综合实战

效果

  1. 前端部分
    (1). html
    (2). css
  2. PHP编程
    2-1. 基础语法
    2-2. 全局变量
  3. 综合实战
  • 前端部分
    • html
    • css
  • PHP编程
    • 基础语法
    • 全局变量
  • 综合实战

4. 引用

语法 行引用是:>+空格+内容,行内引用是:`+内容+`

  • 行引用要在行首才有效,行内引用在行内任何位置都可以

源码

  1. >我是一行引用
  2. 这里演示`行内引用`

效果

我是一行引用

这里演示 行内引用


5. 代码块

语法

  • 单行代码同行内引用一样,都是 `+内容+`
  • 多行代码块则```+(换行)+内容+(换行)+```,可以指定代码类型,如html、php和shell等,则自动高亮显示对应语法的关键字。

源码

  1. 单行代码块:`<script>console.log('Hello World!');</script>`
  2. 多行代码块(这里省略多行代码块标签):
  3. $name='woxiaoyao';
  4. echo $name;

效果

<script>console.log('Hello World!');</script>

  1. $name='woxiaoyao';
  2. echo $name;

6. 链接

语法

  • 只显示链接文本: [内容](地址+空格+提示),提示可以不写
  • 全显示: [内容](地址)<地址>
  • 只显示链接: 内容<地址>

代码

  1. [PHP中文网](https://www.php.cn 'PHP爱好者聚集乐园')
  2. [PHP中文网](https://www.php.cn 'PHP爱好者聚集乐园')<https://www.php.cn>
  3. PHP中文网<https://www.php.cn>

效果

PHP中文网
PHP中文网https://www.php.cn
PHP中文网https://www.php.cn


7.图片

语法

图片语法就是在链接语法前面加上感叹号!

代码

  1. ![十三期前端开发](https://s1.ax1x.com/2020/10/19/0ve4zV.png '前端开发')

效果

十三期前端开发


8.表格

语法

  • 表格由 |和- 画出,其中|表示竖向分割线,-表示横向分割线
  • 表格由 表头+表格式+表内容 组成,表格式使用 冒号: 可以指定左、中、右对齐
  • 表格更复杂操作、如颜色、列宽、合并等则需要html标签table来实现了

代码

  1. |序号|内容|时间|讲师| **表头**
  2. |:-:|---|---|----:| **表格式**
  3. |1|前端开发|5周|朱老师| **表内容**
  4. |2|PHP编程|4周|朱老师|
  5. |3|综合实战|5周|灭绝/西门|

效果

序号 内容 时间 讲师
1 前端开发 5周 朱老师
2 PHP编程 4周 朱老师
3 综合实战 5周 灭绝/西门

三、个人总结

语法标签分类

  • 单个标签: 如标题#、引用>、有序列表和无序列表等。
    +标签在 行首 才有效
    +标签和内容之间有 空格,引用>和内容之间有无空格均可以

  • 成对标签: 如引用``,代码块```,强调 ,斜体*等。
    +标签和内容之间一般
    不用空格
    +标签与外部文本之间
    要有空格**

  • 复合标签: 如链接 []()<> ,图上 ![](),表格等
    +标签与内容之间不需要空格

  • 生成目录 使用[toc]即可

几个特殊符

  • 1个空格: 常用于语法标签与普通文本的分隔、链接或图片中提示文本与地址之间
  • 2个空格: 如行内换行时需要两个空格+回车,无序列表下一级前面有空格
  • 空行 建议不同语法标签之间要用空行分隔,否则易出现想不到效果
声明:本文内容转载自脚本之家,由网友自发贡献,版权归原作者所有,如您发现涉嫌抄袭侵权,请联系admin@php.cn 核实处理。
全部评论
文明上网理性发言,请遵守新闻评论服务协议