Markdown 基本语法

目录

前言

Markdown 语法

Markdown 说明

Markdown 标题

1. 使用 = 和 - 标记一级和二级标题

2. 使用 # 号标记

Markdown 段落

1. 段落说明

2. 字体格式

3. 分隔线

4. 删除线

5. 下划线

6. 脚注

Markdown 列表

1. 无序列表

2. 有序列表

3. 列表嵌套

Markdown 区块

1. 区块定义

2. 区块嵌套

3. 区块中使用列表

4. 列表中使用区块

Markdown 代码

1. 代码片段

2. 代码区块

Markdown 链接

1. 链接

2. 高级链接

Markdown 图片

1. 图片语法格式

2. 图片样式

Markdown 表格

1. Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行

2. 语法格式 && 对齐方式

Markdown 使用技巧

1. 支持的 HTML 元素

2. 转义

3. 公式

Obsidian 使用

1. 高亮显示文字

2. 任务列表

3. 文章间链接(双链:入链、出链)


前言

        因为之前都在用word简单记笔记挺麻烦,几天前换了一个记笔记的软件 Obsidian(黑曜石),当时了解了挺多款的(语雀、notion、思源、XMind、Obsidian),最后考虑到免费、方便、存本地,选择了Obsidian。

        Obsidian 是用的 Markdown 编写的,所以又花了一天时间学 Markdown 以及 Obsidian 的基本使用,整理如下(常用已标红)。


Markdown 语法

Markdown 说明

        * Markdown 是一种轻量级标记语言,允许人们使用易读易写的纯文本格式编写文档;
        * Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档;
        * Markdown 编写的文档后缀为 .md, .markdown。

Markdown 标题

1. 使用 = 和 - 标记一级和二级标题

        这表示一级标题
        =================

        这表示二级标题
        ------------------------------


2. 使用 # 号标记

        #                一级标题
        ##              二级标题
        ###            三级标题
        ####          四级标题
        #####        五级标题
        ######      六级标题

        注:最多只有六级标题

Markdown 段落

1. 段落说明

        段落直接编写文字,没有特殊格式。
        段落的换行是使用两个以上空格加上回车
        段落后面使用一个空行来表示重新开始一个段落


2. 字体格式

        斜体
                * 斜体文本 *
                _ 斜体文本 _(单下划线)

        粗体
                ** 粗体文本 **
          
      __ 粗体文本 __(两下划线)

        粗斜体
                *** 粗斜体文本 ***
                ___ 粗斜体文本 ___(三下划线)


3. 分隔线

        可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西,但可以在星号或是减号中间插入空格。

        以下六种形式都能生成下划线
        ***
        * * *
        *****

        ---
        - - -
        ----------


4. 删除线

        段落上的文字要添加删除线,只需要在文字的两端加上两个波浪线 ~~ 即可


        ~~删除线文本~~


5. 下划线

        可以通过 HTML 的 u 标签来实现


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


6. 脚注

        脚注是对文本的补充说明,格式 [ ^ 内容 ]


        [^要注明的文本]

Markdown 列表

1. 无序列表

        无序列表使用星号、加号(+)或是减号(-)作为列表标记,这些标记后面要添加一个空格


        * 无序列表第一项 *
        + 无序列表第二项 +
        - 无序列表第三项 -


2. 有序列表

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


        1. 有序列表第一项
        2. 有序列表第二项
        3. 有序列表第三项


3. 列表嵌套

        列表嵌套只需在子列表中的选项前面添加四个空格即可


        1. 有序列表第一项
                * 有序列表嵌套的无序列表第二项*
                * 有序列表嵌套的无序列表第二项*

Markdown 区块

1. 区块定义

        Markdown 区块引用是在段落开头使用 > 符号 ,后面紧跟一个空格符号


        > 区块引用


2. 区块嵌套

        区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推


        > 区块最外层
        >>        区块第一层嵌套
         >>>                区块第二层嵌套


3. 区块中使用列表

        > 区块中使用列表
        > 1. 有序列表第一项
        >        * 无序列表第一项
        >        * 无序列表第二项


4. 列表中使用区块

        在列表项目内放进区块,那么就需要在 > 前添加四个空格的缩进


        * 第一项
        > 列表区块第一行
        > 列表区块第二行

Markdown 代码

1. 代码片段

        段落上的一个函数或片段的代码可以用反引号把它包起来


        ` printf() `  函数


2. 代码区块

        代码区块使用 4 个空格 或者一个 制表符(Tab 键)
        也可以用 三个反引号包裹一段代码,并指定一种语言(可以不指定)


        java
        {
                代码内容 ;
        }

        或者


        ```java
        代码内容 ;
        ```

Markdown 链接

1. 链接

        链接使用方法:[链接名称] (链接地址)  /或者/  <链接地址>


        这是一个链接: [百度](https://www.baidu.com)
        这是一个链接:<https://www.baidu.com>


2. 高级链接

        可以通过变量来设置一个链接,变量赋值在文档末尾进行


        这个链接用 baidu 作为网址变量 [百度] [baidu]
        
        [baidu]: http://www.baidu.com/        (文档末尾网址赋值)

Markdown 图片

1. 图片语法格式

        ! [图片的替代文字] (图片地址 "可选标题")


        ![RUNOOB 图标](http://static.runoob.com/images/runoob-logo.png "RUNOOB")


2. 图片样式

        Markdown 还没有办法指定图片的高度与宽度,定义可以使用普通的 < img > 标签


        <img src="http://static.runoob.com/images/runoob-logo.png" width="50%">

Markdown 表格

1. Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行

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


2. 语法格式 && 对齐方式

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

Markdown 使用技巧

1. 支持的 HTML 元素

        目前支持的 HTML 元素有:`<kbd> <b> <i> <em> <sup> <sub> <br>`等


2. 转义

        使用反斜杠转义特殊字符


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


3. 公式

        格式 `$ ... $` 或者 `( ... )`  中的数学表达式将会在行内显示。
        格式 `$$ ... \$$` 或者 `[ ... ]` 中的数学表达式将会在块内显示。
                注:这里$前没有 ‘\’ ,不加会乱码...


Obsidian 使用

1. 高亮显示文字

        文字两端双等号包裹可高亮显示


2. 任务列表

        代办列表格式: - [ ]  、- [x]
        快捷键:(ctrl + 回车)也可实现
 

3. 文章间链接(双链:入链、出链)

        链接整篇文章: [[ 链接文章 ]]

        链接文章一段落 (有标题):[[ 链接文章#文章标题]]

        链接文章一段落 (无标题):[[ 链接文章#^文章段落]]

        链接文章起别名:[[ 链接文章 | 别名 ]]

        显示链接文章: ![[ 链接文章 ] ]

        [[ 链接文章 ]]                               一整篇文章链接

        [[ 链接文章 # 标题1 ]]                  显示文章的具体一段落(标题:文章标题)

        [[ 链接文章#^8c5cef ]]                 显示文章的具体一段落(^8c5cef:段落标号)

        [[ 链接文章#^8c5cef | hello ]]      别名 hello 代替原链接文本显示

        ![[ 链接文章#^8c5cef ]]                直接在文章中显示链接文章


记录

        2022-06-06

  • 1
    点赞
  • 10
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

无敌暴龙战士朵拉

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值