MarkDown语法

什么是MarkDown

123
  markdown是一种轻量级标记语言,它简洁语法,写文章更加轻松,易于阅读,markdown具有美观的排版,可内联HTML,可扩展(eimoji表情,自定义样式设计,可转为PDF,World等格式),可书写数学表达式,逻辑图,可插入图片,链接等

MarkDown的优点

  • 专注你的文字内容而不是排版样式,安心写作。
  • 轻松的导出 HTML、PDF 和本身的 .md 文件。
  • 纯文本内容,兼容所有的文本编辑器与字处理软件。
  • 随时修改你的文章版本,不必像字处理软件生成若干文件版本导致混乱。
  • 可读、直观、学习成本低。

We believe that writing is about content, about what you want to say – not about fancy formatting.
  我们坚信写作写的是内容,所思所想,而不是花样格式。
— Ulysses for Mac

MarkDown在线编辑器

  此编辑器未曾留下姓名大佬基于开源项目mavonEditor开发,扩展了HTML复制、html文件导出、md文件导出等功能,戳这里https://markdowneditor.cn,这个编辑器放到文章里是为了方便读者在阅读文章时可以实际操作,更快的上手markdown

MarkDown语法篇

注意 markdown中涉及的符号均为半角!!!
语法中会有空格和空行,书写出现问题时,查看格式中是否有空格或空行

标题

  由于设置标题会影响排版,所以就不写例子了。如果想看具体样式可以跳转到markdown-editor

    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题  <!--最多6级标题-->

    `#`要和标题空一格

缩进

 &emsp; 全角
 &ensp; 半角

换行

  在行末空格加回车或者Html的br标签

对齐

  markdown不支持对齐,但markdown支持html标签和css样式,可以使用html+css样式惊醒对齐,一般对齐如下

  <center>居中</center> or <p style="text-align: center">居中</p>
  <p align="right">右对齐</p> or <p style="text-align: right">右对齐</p>
  <p align="left">左对齐</p> or <p style="text-align: left">左对齐</p>

字体

粗体

  **粗体文字**
  ***加粗体***

斜体

  _斜体_
  是半角下划线哦!

删除线

  ~~删除线~~

下划线

  ++下划线++

背景高亮

  ==背景高亮==

链接

行内链接

  [链接描述](链接网址)

  举个栗子: 博客园

标注式链接

  最喜欢逛[博客园][1]啦~~

  [1]:https://www.cnblogs.com
 

冒号后不要有空格, 标注文字与被标注文字空一行,避免解析错误

最喜欢逛博客园啦~~

锚点链接

锚点链接其实就是HTML的a链接,锚点跳转点就是#+元素id

  [我是锚点](#index)
  <p id="index">我是锚点跳转落点</p>

我是锚点

我是锚点跳转落点

自动链接

  Marndown可将<>内的网址或电子邮箱转化成HTML的a链接

  <链接网址>

博客园在右边https://www.cnblogs.com

插入图片

  ![图片加载失败显示的图片描述](图片地址)

123

分割线

  1. ***
  2. * * *
  3. ****
  4. - - -
  5. ---

  方式1


  方式2


  方式3


  方式4


  方式5


目录

  markdown会将大、小标题汇总成一个目录,前提是声明目录的命令


 [toc]

举个栗子:

点击这里

列表

有序列表

  编号. 内容

  比如: 
    1. 吃饭
    2. 睡觉
    3. 打豆豆

举个栗子

  1. 吃饭
  2. 睡觉
  3. 打豆豆

无序列表

  * 内容 or - 内容 or + 内容

  比如:
   * 吃饭 or
   - 睡觉 or
   + 打豆豆

举个栗子

  • 吃饭
  • 睡觉
  • 打豆豆

任务列表

 - [x] 已完成状态
 - [ ] 未完成状态

  博客园似乎没有显示任务列表样式,可以在markdown-editor中或其他markdown编辑器查看样式。

代码块

  代码是写程序必不可少的,markdown为了让代码正常书写而不会出现解析问题,提供了代码块功能,语法是使用上下共6个反引号,代码书写在反引号之间

常规代码块

  \`\`\`
    我是代码块
  \`\`\`

  由于代码块不能支持嵌套所以,这里问了演示,我就用转义字符转义,防止解析出现奇怪的问题

Java代码

戳我查看代码
  public class User {
    private String userName;
    private int age;

    public User(String name, int age) {
       this.userName = name;
       this.age = age;
    }

    public String toString() {
      return `User = { userName:' + userName + ', age: ' + age + '}';
    }
  }

JavaScript代码

戳我查看代码
  class User {
    constructor(options) {
       this.userName = options.name;
       this.age = options.age;
    }
  }


行内代码块

  一般文字`我是行内代码块`一般文字

举个栗子
  vite可通过yarn create vite app即可安装

引用

  > 在这里写引入的内容

  >后面空一个

举个栗子

科学是人们生活中最重要、最美好和最需要的东西。

——— 契诃夫

表格

  markdown通过简单的语法就可以写出表格,当然,HTML方式也是可以写,只是比较麻烦

  |字段1|字段2|字段三|
  |:-:|:-|-:|
  |居中|左对齐|右对齐|

 `|`是shift+回车上方的按键 

  举个栗子

字段1 字段2 字段三
居中 左对齐 右对齐

角标

上角标

  语法

  2^10^

栗子: 210

下角标

  log~2~8

栗子: log28

折叠块

  <details>
    <summary>戳我显示隐藏内容</summary>

    这里写折叠的内容
  </details>

戳我显示隐藏内容
这里写折叠的内容

注脚

  注脚

  HTML是 超文本标记语言[^1]

  [^1]:`HTML全称: HyperText Markup Language`
  !!空一行!!
  [^2]:`HTML全称: HyperText Markup Language`

举个栗子

HTML是 超文本标记语言[1][2][3]

特殊字符对照表

戳我显示对照表
特殊字符 描述 字符代码
  空格符 &nbsp;
& 逻辑与 &amp;
< 小于号 &lt;
> 大于号 &gt;
¥ 人民币 &yen;
± 正负号 &plusmn;
× 乘号 &times;
÷ 除号 &divide
© 版权符号 &copy;
® 注册商标符号 &reg;
°C 摄氏度 &deg;C
« 双小于号 &laquo;
» 双大于号 &raquo;
² 平方 &sup2;
³ 立方 &sup3;
半角空格 &ensp;
全角 &emsp;
" 双引号 &quot;
' 单引号 &apos;
¯ 上划线 &macr;
£ &pound;
大于等于 &ge;
小于等于 l&e;
三横线 &equiv;
约等于 asymp;
¼ 四分之一 &frac14;
½ 二分之一 &frac12;
¾ 三分之四 &frac34;
五分之二 &frac25;
千分号 &permil;
ƒ 函数符号 &fnof;
角符号 &ang;
无穷 &infin;
积分 &int;
π π &pi;
回车 &crarr;
¿ 倒问号 &iquest;
TM &trade;
爱心 &hearts;
特殊符号 &lceil;
特殊符号 &rceil;
特殊符号 &lfloor;
特殊符号 &rfloor;
Ω 数学符号 &Omega;
β 数学符号 &beta;
Σ 数学符号 &Sigma;
α 数学符号 &alpha;
求和 &sum;
根号 &radic;
左箭头 &larr;
右箭头 &rarr;
上箭头 &uarr;
下箭头 &darr;
左箭头 &lArr;
右箭头 &rArr;
上箭头 &uArr;
下箭头 &dArr;

其他字符请参考w3cSchool的HTML ISO-8859-1 参考手册


  语法偏多,但很多都是多次使用就可以记住的,大家可以按照使用频率来对语法分层掌握,先掌握基础的标题,链接,图片,列表,然后学习复杂的表格,文字排版,代码块,锚点,公式等,特殊字符查表即可,无需记忆。希望大家尽快掌握语法,体验其中的乐趣。


  1. HTML全称: HyperText Markup Language ↩︎

  2. HTML全称: HyperText Markup Language ↩︎

  3. HTML全称: HyperText Markup Language ↩︎

posted @ 2021-10-04 17:13  远方有你,伴余生  阅读(226)  评论(0编辑  收藏  举报