Markdown学习笔记

Markdown 学习相关与总结

编辑器的选择

Markdown编辑器有很多,下面是我目前接触到的两种:

  • stackedit中文版 这是一个在线编辑器,可离线缓存
  • VScode 应用广泛,安装markdown插件即可提升md文件编辑体验

标题的相关语法

Markdown中标题分级,且共有两种分级格式

  • 使用 = 和 - 标记一级和二级标题

    一级标题
    =================
    二级标题
    -—————-

  • 使用 # 号标记

    # 一级标题
    ## 二级标题
    ### 三级标题

需要注意的是,一级和二级标题下有下划线,而三级标题开始是由短竖线开始

段落及其格式

  • 换行

    1. 段落后使用两个以上空格加上回车可换行,同时使用制表符tab再回车同样可换行

      第一行空格空格
      第二行

    第一行Tab
    第二行

    1. 也可以在段落后面使用一个空行来表示重新开始一个段落

      第一行

      第二行

  • 字体
    Markdown中可使用字体有限,当然这也保持了文档的简洁,在markdown中可使用以下字体:

    *斜体文本*
    _斜体文本_
    **粗体文本**
    __粗体文本__
    ***粗斜体文本***
    ___粗斜体文本___

  • 线

    1. 可以在一行中用三个以上的星号*、减号-、底线_来建立一个分隔线,行内不能有其他东西。

      ***
      * * *
      *****
      -----
      ---------

    2. 可以在文字的两端加上两个波浪线~~来建立一个删除线

      ~~删除线~~

    3. 可以通过HTML语言的<u>标签来建立一个下划线

      <u>带下划线文本</u>

  • 脚注[1]
    脚注的添加有如下格式:

    创建脚注格式类似这样 [^2]
    [^2]: 我 是 真 焦 虑

创建脚注格式类似这样 [2]

列表

  • 无序列表
    无序列表使用星号*、加号+或是减号-作为列表标记,这些标记后面要添加一个空格,然后再填写内容

    * 第一项
    * 第二项
    * 第三项
    + 第一项
    + 第二项
    + 第三项
    - 第一项
    - 第二项
    - 第三项

  • 有序列表使用数字并加上.号来表示

    1. 第一项
    2. 第二项
    3. 第三项

  • 列表的嵌套
    列表嵌套只需在子列表中的选项前面添加两个或四个空格即可
    1. 第一项:
      - 第一项的第一个元素
      - 第一项的第二个元素
    2. 第二项:
      - 第二项的第一个元素
      - 第二项的第二个元素

值得注意的是,在markdown中,父子关系的缩进都是四个空格

区块

  • 在段落开头使用>符号加空格来定义区块

    > 区块第一行
    > 区块第二行
    > 区块第一行

  • 区块和列表之间也可以建立父子关系,这有助于我们进行信息的索引

    > 区块中使用列表
    > 1. 第一项
    > 2. 第二项
    > + 第一项
    > + 第二项
    > + 第三项

代码块

  • 片段
    代码片段使用反引号`将其括起来

    `printf()`
    `if else`

  • 区块
    使用```包裹一段代码,并指定一种语言(在第一行标明即可)

    ```python
    str1 = ‘hello’
    str2 = ‘world’
    print(str1 + ‘ ‘ + str2)

    1
    2
    3
    4
    5

    ```python
    str1 = 'hello'
    str2 = 'world'
    print(str1 + ' ' + str2)

链接

  • 一般链接
    链接的一般使用方法包括文字引用和直接链接

    [链接名称](链接地址)
    或者
    <链接地址>

  • 高级链接
    通过一个变量来设置链接,这样的方法方便随时更改链接地址

    这是一个高级链接,使用1作为变量
    [scu][1]
    [1]: `https://www.scu.edu.cn/

效果: scu

图片

  • Markdown图片语法格式为:

    ![alt 属性文本](图片地址)
    ![alt 属性文本](图片地址 “可选标题”)

    图片地址可以是本地地址或网络地址,在hexo博客文章的本地地址引用中,通常是本地博客目录下的\source\img的图片,地址为\img\eg-code.png,‘eg-code.png’为图片名称

表格

  • 单元格的分隔使用竖线|,表头和其他行使用短横线----

    | 表头 | 表头 |
    | —- | —- |
    | 单元格 | 单元格 |
    | 单元格 | 单元格 |

  • 另外,我们还可以设置表格的对齐方式

    -: 设置内容和标题栏居右对齐
    :- 设置内容和标题栏居左对齐
    :-: 设置内容和标题栏居中对齐

    注意,这些语法和行分隔线相关联

    | 左对齐 | 右对齐 | 居中对齐 |
    | :—–| —-: | :—-: |
    | 单元格 | 单元格 | 单元格 |
    | 单元格 | 单元格 | 单元格 |

左对齐 右对齐 居中对齐
单元格11111 11111单元格 11单元格111
单元格 单元格 单元格

其他技巧

  • 支持的 HTML 元素
    markdwon支持部分html元素如:<kbd> <b> <i> <em> <sup> <sub> <br>等,(也许之后系统学习html会专门写一篇博客来介绍(bushi))

    使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 获取期末答案

    使用 Ctrl+Alt+Del 获取期末答案

  • 转义
    和python,c一样,使用反斜杠转义特殊字符

    **文本加粗**
    \*\* 正常显示星号\*\*

    文本加粗
    ** 正常显示星号 **

  • 公式
    在markdown中,对数学公式默认有两种分隔符

    1. $…$ 或者\(…\) 中的数学表达式将会在行内显示。
    2. $$…$$ 或者 \[…\] 或者 ```math 中的数学表达式将会在块内显示。

    ‘’Markdown Preview Enhanced 使用 KaTeX 或者 MathJax 来渲染数学表达式。

    KaTeX 拥有比 MathJax 更快的性能,但是它却少了很多 MathJax 拥有的特性。你可以查看 KaTeX supported functions/symbols 来了解 KaTeX 支持那些符号和函数。’’
    引用自菜鸟教程

(待补充)

  1. 脚注是对文本的补充说明
  2. 我 是 真 焦 虑

Markdown学习笔记
http://lanternflew.github.io/2024/04/19/Markdown学习笔记/
作者
灯梦初秋
发布于
2024年4月19日
许可协议