511

MarkDown超级教程 Obsidian版(超详细实用)

 2 years ago
source link: https://www.aceact.com/efficiency/214.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

--本文为转载--​

什么是 Markdown?

  1. Markdown 是一款轻量级标记语言,不同于HTML (Hypertext Markup Language)Markdown 的语法非常简单,且容易上手
  2. Markdown纯文本格式 编写文档,依赖键盘而非鼠标,专注于写作本身,感受书写的魅力
  3. Markdown 的通过添加一些简单的 标识符,让文本具有恰到好处的格式
  4. Markdown 核心特征就是 删繁剪芜简扼 + 精炼
  5. Markdown笔记网页文章 的最佳载体
  6. Down 的核心:坐 来,就能把思维写

    • 牛津高阶英汉双解词典第九版 中,关于 down 的释义:

Markdown 相关软件推荐

Markdown 语法

  • 提示1: 本教程推荐使用 Obsidian 打开阅读
  • 提示2: 下文提到的所有标识符都是 英文状态

1. 标题&目录

1.1 标题

  • Markdown标题共有 六级,和 HTML 一样
  • 区分 一级标题 → 六级标题

    • 标题 的格式:

      • # × 标题级数 + 空格 + 文本内容
这是一段普通的文本

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

1.2 目录

  • 目录的 格式:

    • 在文档的顶部 输入 [toc] ,会根据 标题 自动生成目录 ( Table of Content )
  • 不是所有 MD编辑器 都支持目录生成
输入下方内容会生成一个目录:

[toc]

2. 斜体&粗体

2.1 斜体

  • 斜体 的格式:

    1. * + 文本内容 + *
    2. _ + 文本内容 + _ ( 下划线 )
  • 说明:

    • 斜体文本,首尾只有 单个 标识符
这是一段普通文本

*这里是一段斜体文本*
_这也是一段斜体文件_

这是一段普通文本

这里是一段斜体文本
这也是一段斜体文件

2.2 粗体

  • 粗体 的格式:

    1. ** + 文本内容 + **
    2. __ + 文本内容 + __ (这里是两个 _ )
  • 说明:

    • 粗体文本,首尾各有 两个 标识符
这是一段普通文本

**这里是一段加粗文本**
__这也是一段加粗文本__

这是一段普通文本

这里是一段加粗文本
这也是一段加粗文本

2.3 粗斜体 (斜粗体)

  • 粗斜体 的格式:

    1. *** + 文本内容 + ***
    2. ___ + 文本内容 + ___ ( 这里是3个 _ )
    3. **_ + 文本内容 + _**
    4. __* + 文本内容 + *__
    5. *__ + 文本内容 + __*
    6. _** + 文本内容 + **_
  • 说明:

    • 粗斜体文本,首尾各有 三个 标识符
这是一段普通文本

***粗斜体文本1***
___粗斜体文本2___
**_粗斜体文本3_**
__*粗斜体文本4*__
*__粗斜体文本5__*
_**粗斜体文本6**_

这是一段普通文本

粗斜体文本1
粗斜体文本2
粗斜体文本3
粗斜体文本4
粗斜体文本5
粗斜体文本6

2.4 斜体包含粗体

  • 斜体中包含粗体 的格式:

    1. * + 斜体文本 + ** + 粗体文本 + ** + 斜体文本 + *
    2. _ + 斜体文本 + __ + 粗体文本 + __ + 斜体文本 + _ ( 这里是两个 _ )
    3. * + 斜体文本 + __ + 粗体文本 + __ + 斜体文本 + *
    4. _ + 斜体文本 + ** + 粗体文本 + ** + 斜体文本 + _
  • 说明:

    • 斜体 中包含 粗体,其实就是嵌套的关系,外层斜体内层粗体
    • 外层是斜体,标识符是单个;内层是粗体,标识符是两个
    • 因为 粗体 是被包裹在 斜体 中的,所以显示效果为 斜粗体
这是一段普通文本

*这里是一段斜体中**包含粗体**的文字*
_这也是一段斜体中**包含粗体**的文字_
*这又是一段斜体中__包含粗体__的文字*
_这还是一段斜体中**包含粗体**的文字_

这是一段普通文本

这里是一段斜体中包含粗体的文字
这也是一段斜体中包含粗体的文字
这又是一段斜体中__包含粗体__的文字
这还是一段斜体中包含粗体的文字

2.5 粗体包含斜体

  • 粗体中包含斜体 的格式:

    1. ** + 粗体文本 + * + 斜体文本 + * + 粗体文本 + **
    2. __ + 粗体文本 + _ + 斜体文本 + _ + 粗体文本 + __ ( 这里是两个 _ )
    3. ** + 粗体文本 + _ + 斜体文本 + _ + 粗体文本 + **
    4. __ + 粗体文本 + * + 斜体文本 + * + 粗体文本 + __
  • 说明:

    • 粗体 中包含 斜体,也就是嵌套的关系,外层粗体内层斜体
    • 外层是粗体,标识符是两个;内层是斜体,标识符是单个
    • 因为 斜体 是被包裹在 粗体 中的,所以显示效果为 粗斜体
这是一段普通文本

**这里是一段粗体中*包含斜体*的文字**
__这也是一段粗体中_包含斜体_的文字__
**这又是一段粗体中_包含斜体_的文字**
__这还是一段粗体中*包含斜体*的文字__

这是一段普通文本

这里是一段粗体中包含斜体的文字
这也是一段粗体中_包含斜体_的文字
这又是一段粗体中_包含斜体_的文字
这还是一段粗体中包含斜体的文字

3.1 水平分割线

  • 水平分割线由至少 3*- 组成
下面是一条水平分割线:
---
***

3.2 文本删除线

  • 删除线 的格式:

    • ~~ + 文本内容 +~~ 首尾各加两个 ~ 波浪号
~~这是一段加了删除线的文本~~

这是一段加了删除线的文本

3.3 文本下划线

  • 下划线的格式,和 HTML 是一样的

    • <u> + 文本内容 + </u>
<u>这是一段加了下划线的文本</u>

这是一段加了下划线的文本

4. 列表&引用

4.1 有序列表

  • 有序列表 的格式:

    • 1. + 空格 + 文本内容
  • 说明:

    • 输入文本内容后,敲击 Enter 自动补全格式,并进入 下个 有序列表
    • 若需要在同个列表内,增加 换行显示 的内容 (但不进入下个列表)
      敲击 Shift + Enter ,即可另起一行输入文本
    • 在有序列表的中间,插入一个新的列表,后面列表的 数字序号 会自动 递进 一层
    • 即便在源代码模式中修改了数字序号,渲染界面依然是 依照顺序 显示的
1. 这是第一个有序列表 <!-- (Enter) -->
2. 这是第二个有序列表 <!-- (Enter) -->
3. 这是第三个有序列表 


1. 这是第一个有序列表 <!-- (Shift + Enter) -->
   这是同个列表下,另起一行的文本内容 <!-- (Enter) -->
2. 这是第二个有序列表 <!-- (Shift + Enter) -->
   这是同个列表下,另起一行的文本内容 
  1. 这是第一个有序列表
  2. 这是第二个有序列表
  3. 这是第三个有序列表
  1. 这是第一个有序列表
    这是同个列表下,另起一行的文本内容
  2. 这是第二个有序列表
    这是同个列表下,另起一行的文本内容
  • 由于有序列表存在强制排序性,它的数字序号必然是逐一递进
    若你希望内容前的数字,不依照递进顺序排序,或者以 整百整十数 排序
  • 可以配合无序列表,在无序列表中输入:

    • 数字 + . + 内容

      注意 点号 与 内容 之间,没有空格 (其实有空格也行,就是会感觉有点奇怪)

- 10.这是无序列表下,整十数排列的内容- 20.这是无序列表下,整十数排列的内容- 30.这是无序列表下,整十数排列的内容- 100.这是无序列表下,整百数排列的内容- 200.这是无序列表下,整百数排列的内容- 300.这是无序列表下,整百数排列的内容

效果:

  • 10.这是无序列表下,整十数排列的内容
  • 20.这是无序列表下,整十数排列的内容
  • 30.这是无序列表下,整十数排列的内容
  • 100.这是无序列表下,整百数排列的内容
  • 200.这是无序列表下,整百数排列的内容
  • 300.这是无序列表下,整百数排列的内容

4.2 无序列表

  • 无序列表 的格式:
  • - + 空格 + 文本内容
  • 说明:

    • 输入文本内容后,敲击 Enter 自动补全格式,并进入 下个 无序列表
    • 若需要在同个列表内,增加换行显示的内容 (但不进入下个列表)
      敲击 Shift + Enter ,即可另起一行输入文本
  • 补充:

    • Obsidian中,按下 Ctrl + Enter
    • 即可快速生成一个无序列表
- 这是第1个无序列表 <!-- (Enter) -->- 这是第2个无序列表 <!-- (Enter) -->- 这是第3个无序列表- 这是第一个无序列表 <!-- (Shift + Enter) -->  这是同个列表下,另起一行的文本内容- 这是第二个无序列表 <!-- (Shift + Enter) -->  这是同个列表下,另起一行的文本内容 
  • 这是第1个无序列表
  • 这是第2个无序列表
  • 这是第3个无序列表
  • 这是第一个无序列表
    这是同个列表下,另起一行的文本内容
  • 这是第二个无序列表
    这是同个列表下,另起一行的文本内容

4.3 引用

  • 引用 的格式:

    • > + 文本内容 (不需要空格)
  • 说明:

    • 同个引用段落内的换行直接敲击 Enter 即可
    • 若需添加 第二个独立引用段落 ,连续敲击 两下 Enter 即可
>这是第一段引用文本的第1行 <!-- (Enter) -->
>这是第一段引用文本的第2行 <!-- (Enter) -->
<!-- (Enter) -->
>这是第二段引用文本的第1行 <!-- (Enter) -->
>这是第二段引用文本内第2行

这是第一段引用文本的第1行
这是第一段引用文本的第2行

这是第二段引用文本的第1行
这是第二段引用文本的第2行

4.4 缩进&退格

在列表和引用的书写过程中,我们需要利用 ==缩进== 与 ==退格== ,让文章肌理分明,更具层级

  • 缩进:

    1. Tab
    2. Ctrl + [   (左中括号)
  • 退格:

    1. Shift + Tab
    2. Ctrl + ] (右中括号)

4.4.1 有序列表的缩&退

1. 第一级有序列表1 <!-- (Enter) -->
    1. 第二级有序列表1    <!-- 写文本之前,先( Tab 或 Ctrl + ] ) ;写完文本后,再(Enter) -->
    2. 第二级有序列表2 <!-- (Enter) -->
2. 第一级有序列表2    <!-- 写文本前,先 ( Shift + Tab 或 Ctrl + [ ) --> 
  • 补充说明:

    • 有序列表的数字序号,即便你在源代码模式里 强行改掉 数字,它仍然会 依照顺序 显示
  1. 第一级有序列表1

    1. 第二级有序列表1
    2. 第二级有序列表2
  2. 第一级有序列表2

4.4.2 无序列表的缩&退

- 第一级无序列表1 <!-- (Enter) -->
    - 第二级无序列表1  <!-- 写文本前,先( Tab 或 Ctrl + ] ) ;写完后,再(Enter) -->
    - 第二级无序列表2 <!-- (Enter) -->
- 第一级无序列表2  <!-- 写文本前,先 ( Shift + Tab 或 Ctrl + [ ) -->
  • 第一级无序列表1

    • 第二级无序列表1
    • 第二级无序列表2
  • 第一级无序列表2

4.4.3 引用的缩&退

  • 引用的 缩进 和列表 不同

    • 引用需另起一行,并额外多打一个 > 来完成 缩进
  • 引用的 退格 与列表 相同

    1. Shift + Tab
    2. Ctrl + ] (右中括号)
>第一级引用1 <!-- (enter) -->
>>第二级引用1 <!-- 先打1个 > (这里的第一个 > 是会自动补充的,只需额外增补1个即可) ,再(enter) -->
>>第二级引用2 <!-- (enter) -->
>第一级引用2   <!-- 写文本前,先 ( Shift + Tab 或 Ctrl + [ ) -->

第一级引用1

第二级引用1
第二级引用2

第一级引用2

  • 补充:
    Obsidian 中,引用的退格是不太一样的
  • Obsidian 中,如果想让已经缩进的引用 退回一层

    • 得使用 Shift + Enter ,配合方向键,在多个 > 之间灵活断行
      并在下一行 根据需要 选择性补充 >
  • 这个用文字比较难以描述,这里选择用2个带键位的 Gif图 来描述

Gif演示1:

  • 效果1:

333

Gif演示2:

  • 效果2:

333

555

4.4.4 有序&无序&引用 连续套娃

  • 有序列表无序列表引用 三者之间,可以相互嵌套
  • 核心键Shift + Enter & Enter & Shift + Tab ( 或 Ctrl + [ )

    • Shift + Enter 在切换格式的嵌套中,是 自带一层 缩进 效果的
1. 第一级 有序列表1 <!-- (Shift + Enter) --> 
    - 第二级 无序列表1 <!-- (Shift + Enter) -->
        >第三级 引用1  <!-- (Enter) -->
            - 第四级 无序列表2 <!-- (Shift + Enter) -->
                1. 第五级 有序列表2 <!-- (Enter) -->
            - 第四级 无序列表3   <!-- 写文本前,先( Shift + Tab 或 Ctrl + [ ) ;写完后再 (Enter) -->
        >第三级 引用2  <!-- 写文本前,先( Shift + Tab 或 Ctrl + [ ) ;写完后再 (Enter × 2) -->
    - 第二级 无序列表4  <!-- 写文本前,先( Shift + Tab 或 Ctrl + [ ) -->
2. 第一级 有序列表3  <!-- 写文本前,先( Shift + Tab 或 Ctrl + [ ) -->
  1. 第一级 有序列表1

    • 第二级 无序列表1

      第三级 引用1

      • 第四级 无序列表2

        1. 第五级 有序列表2
      • 第四级 无序列表3

      第三级 引用2

    • 第二级 无序列表4
  2. 第一级 有序列表3

4.4.5 Obsidian 的一些缩退问题

  • Obsidian 在列表首行使用缩进的时候,后续的列表会出现一些问题

    • TabShift + tab 会无法 缩进 退格

      • 可以使用 Ctrl + ]Ctrl + [ 来解决问题
- - 这是第一段就被缩进的列表    - 这是第二段被再次缩进的列表  <!-- 这里需按两次 Ctrl + ] ,Tab键是无效的 -->  - 这是第三段列表  <!-- Ctrl + [ -->
    • 这是第一段就被缩进的列表

      • 这是第二段被再次缩进的列表
    • 这是第三段列表

5. 网页链接与图像

5.1 网页链接

  • 网页链接的 格式:

    • [ + 显示文本内容 + ] + ( + 链接地址 + 空格 + " + 提示信息文本 + " + )
  • 说明:

    • 显示文本内容,是在渲染界面实际 可见 的文本,用以 说明 链接
    • 提示信息文本,需鼠标悬停于 显示文本内容 方可触发,用于增加额外提示信息

      • "提示信息文本"可选项,可以不填
      • 一般来讲,需按住 Ctrl + 鼠标左键点击 才可跳转链接,不过也有 直接鼠标点击 就能跳转的
[显示文本内容](链接地址 "提示信息文本")[百度一下,你就知道](http://www.baidu.com "按住Ctrl点击跳转百度")

示范:

百度一下,你就知道

5.1.1链接的加粗

  • 格式有两种:

    1. 把一对 ** 加在 ==显示文本内容==的首尾

      - **格式1:**`[**显示文本内容**](链接地址)` - **效果:** [**百度一下,你就知道**](http://www.baidu.com)
      
      1. 把一对 ** 加在 链接格式==整体== 的首尾

5.2 图像

  • 图像格式:

    • 图像格式,就是在网页链接前面加个 ! (英文格式的),! 代表 可见
    • 图片的提示信息,和网页链接一样,写在 " "
    • [ ] 方括号里的文字信息在 Markdown 没啥实质的作用,只是方便在源代码模式下,知道这个图片是什么,在渲染界面是不会显示的。有点类似于HTML img标签 里的 alt属性
![文字信息](图片链接 "提示文本信息")    ![湘湖1](https://z3.ax1x.com/2021/08/06/fuNkXq.jpg "湘湖一角")
  • 补充:

    • 图像链接可以是本地的,也可以是在线

      • 本地图像直接 Ctrl + C 黏贴,Ctrl + V 复制 就可以
      • 在线图像推荐使用 图床
    • 调整图像的大小需要使用 HTML 和 CSS,在 Typora编辑器 中右键可以直接缩放图片
      本质是转成了HTML的格式,最后会有一个 style="zoom: %;" ,这里数值可以自己修改
    • 如果有使用 Obsidian 的朋友,在线图片链接是通用的。不过,因为 Obsidian 是双向链笔记
      它的本地图片格式不太一样

      • ![[图片名]]

        • 本质是为图片建了一个新的MD文件,以链接的格式引用在目标笔记中,用 ! 使它可见
        • Obsidian的图片设置大小是用 | 分隔,后面写宽度数值,单位是px。
          设定好宽度,高度会自动等比例调整

          • ![[图片名|宽度数值]]
    • 如果是在线图床,需要调整图片大小:

      • ![图床|宽度数值](链接地址)
  • Markdown的表格,比HTML简单很多

    • | 是构成表格的主要 框架
    • - 区分 表头表格主体
    • : 控制 表格内 文本内容对齐方式
    • Typora编辑器中 输入 Ctrl + T 即可快速插入表格,自由定义样式
|这里是表头1|这里是表头2|这里是表头3|
|:-|:-:|-:|    <!--区分表头和表格主体,:代表文本对齐方式,分别是左对齐,居中对齐,右对齐-->
|单元格数据1|单元格数据2|单元格数据3|
|单元格数据4|单元格数据5|单元格数据6|
这里是表头1这里是表头2这里是表头3单元格数据1单元格数据2单元格数据3单元格数据4单元格数据5单元格数据6

6.1 表格内文本内容的换行

  • Mardown中表格,它的宽高是由 单元格数据内的文本内容 撑开
  • 当我们输入一段很长很长的文本,它所在的单元格会变得过宽

如下图所示:

表头1表头2这是一段很长很长很长很长很长很长很长很长很长很长很长很长很长很长的文本普通文本
  • 若想对一段长文本进行换行,可以在 中间 插入一个 <br> ( 换行标签 )
| 表头1 |  表头2 ||:-:|:-:||这是第一行文本<br>这是另起一行的文本|普通文本|
表头1表头2这是第一行文本
这是另起一行的文本普通文本

7. 代码域

7.1 行内代码

  • 行内代码 的格式:

    • 输入两个 ` 反撇号 ,在中间写代码内容
  • 补充:

    • 行内代码不一定非得写代码,也可以作为着重标记,突出显示内容
    • 行内代码中,源代码界面和渲染界面是完全一致的,标识符会失效
    • 所谓行内代码: 只要你的屏幕足够宽,它就不会换行
`这是一段行内代码``<table border="1" cellspacing="0" width="500" height="500">``print("Hello, World!")``这是一行突出显示的文本内容`

<table border="1" cellspacing="0" width="500" height="500">

print("Hello, World!")

这是一行突出显示的文本内容

7.2 代码块

  • 代码块 的格式:

    1. 在首行和末行各加 三个 ` 反撇号

      • ` `` + 语言种类
        代码内容
        ` ``
    2. 在首行和末行各加 三个 ~ 波浪号

      • ~~~ + 语言种类
        代码内容
        ~~~
  • 补充:

    • 在代码块也不一定要写代码,可以写一段突出的文本内容,语言类型可以填写 txt 或者 干脆不写
    • 代码块中,源代码界面和渲染界面是完全一致的,标识符会失效
    • Typora编辑器 ,用键盘按键脱离代码块区域,需输入: Ctrl + Enter

8. 任务列表(待办)

  • 任务列表 的格式:

    • - + 空格 +[ ] +空格 + 任务列表内容 ( 中括号[ ] 里面必须有个空格)
    • 给待办任务列表打 ,变成 已办

      1. 在渲染界面,直接鼠标左键点击框框
      2. 在源代码界面,在中括号内输入 英文字母x

        • 部分编辑器,在 中括号内 输入任意字符都可以打 ( 例如 Obsidian )
  • 补充:

    • 大部分 MD编辑器 支持输入第一个任务列表后,按下 Enter 进入下一行会 自动补全待办格式
    • Obsidian中,连续输入两次 Ctrl + Enter ,即可生成一个待办列表

      • 再输入一次 Ctrl + Enter ,会在待办列表 打
  • 格式:
- [ ] 待办任务列表1
- [ ] 待办任务列表2
- [x] 已办任务列表1    <!-- 英文字母X -->
- [x] 已办任务列表2
  • [ ] 待办任务列表1
  • [ ] 待办任务列表2
  • [x] 已办任务列表1
  • [x] 已办任务列表2
  • Obsidian 中,可以利用 Ctrl + Enter ,快速生成任务列表

    1. - + 空格 + Ctrl + Enter +待办文本内容
    2. 待办文本内容 + Ctrl + Enter ×2   ( 输入文本后,连续2次 Ctrl + enter )
  • 任务列表也是可以缩进+退格的,操作跟 无序、有序列表一样
  • [ ] 第一级待办列表1

    • [ ] 第二级待办列表1
      另起一行的第二级待办列表1

      • [x] 第三级已办列表1
      • [x] 第三级已办列表2
    • [ ] 第二级待办列表2
      另起一行的第二级待办列表2
  • [ ] 第一级待办列表2

Markdown注释HMTL 一样,注释的内容在 渲染界面 不可见 (部分编辑器可见)

  • 注释 的格式:

    • <!-- 这里是注释的内容 -->

      • 注释可以是单行,也可以是多行
    • 如果有在使用 Obsidian 的,它的注释格式是不一样的

      • %%这是Obsidian的注释内容%%
<!-- 这里是一行注释 -->

<!--
这里是
一段
假装有
很多行的
注释
-->

示范 (只有源码模式可以看到噢)

<!--
这里是一段
假装有
很多行的
注释
-->

10. 变量

10.1 网页链接变量

  • 网页链接变量 的格式:

      • [显示文本内容] + [变量名]

        • 变量名可以自己取,没啥限制,任意字符都可以
    1. 在文档任意一个区域,输入:

      • [变量名] + : + 空格 + 链接地址 (这个空格 不打也没事)
[百度一下,你就知道][度娘]
[知乎-有问题,就会有答案][知乎]

<!-- 这里是变量区域 -->
[度娘]: http://www.baidu.com 
[知乎]: https://www.zhihu.com    

百度一下,你就知道

知乎-有问题,就会有答案

10.2 脚注

  • 脚注 的格式:

    • 在需要脚注的地方,输入:

      • [^脚注代号] ( 脚注代号会直接显示在渲染界面 )

        • 脚注代号可以随便命名,不过推荐使用 数字序号
    • 在其他区域,输入:

      • [^脚注代号] + : + 空格 + 脚注内容 (这个 空格 不打也没事)
鲁迅原名是什么[^1] ,浙江哪里人[^2]

<!-- 这里是变量区域 -->
[^1]: 周树人
[^2]: 绍兴人

鲁迅原名是什么1,浙江哪里人2

11. 拓展文本格式标记

  • Markdown 想实现更多的文本显示效果,只能依赖HTML标记实现
  • 个人不是很推荐在 MD 中使用 HTML,不过一些简单的标记还是可以 轻度使用

11.1 键盘文本

  • 键盘文本的 格式:

    • <kbd>键盘文本</kbd>
    • <kbd>Ctrl</kbd> + <kbd>X</kbd>
  • 效果:

    • 键盘文本
    • Ctrl + X ( 剪切 )
  • 说明:

    • 键盘文本也不一定非得是键盘按键,也可以作为着重文本突出显示

      • 效果: 这也算一种着重文本的方式

11.1.1 加粗键盘文本

  • 加粗键盘文本的格式有两种

    • <kbd>**键盘文本**</kbd>
    • **<kbd>ctrl + x</kbd>**
  • 效果:

    1. 键盘文本
    2. ctrl + x

11.2 放大文本

  • 放大文本 的格式:

    • 这是一段普通文本
      <big>这是一段放大文本</big>
  • 效果:

    • 这是一段普通文本
      这是一段放大文本

11.2.1 放大粗体文本

  • 放大加粗文本的格式有两种

    1. **<big>这是一段放大粗体文本</big>**
    2. <big>**这是一段放大粗体文本**</big>
  • 效果:

    1. 这是一段放大粗体文本
    2. 这是一段放大粗体文本

11.3 缩小文本

  • 缩小文本 的格式:

    • 这是一段普通文本
      <small>这是一段缩小文本</small>
  • 效果:

    • 这是一段普通文本
      这是一段缩小文本

11.3.1 缩小斜体文本

  • 斜体缩小文本 的格式有两种

    1. <small>*这是一段缩小斜体文本*</small>
    2. *<small>这是一段缩小斜体文本</small>*
  • 效果:

    1. 这是一段缩小斜体文本
    2. 这是一段缩小斜体文本

11.4 多彩文本

  • 多彩文本 的格式:

    • <font color=orange>这是一段橘色文本</font>
  • 效果:

    • 这是一段橘色文本

11.4.1 多彩粗体文本

  • 只需要在上面示例的基础上,加上 加粗标识符,有两种格式:

    1. 格式1: **<font color=teal>这是一段加粗的水鸭色文本</font>**

      • 效果: 这是一段加粗的水鸭色文本
    2. 格式2: <font color=teal>**这是一段加粗的水鸭色文本**</font>

      • 效果: 这是一段加粗的水鸭色文本
  • 若上述混搭方法的样式失效 ,可以使用 纯HTML标记

    • 格式: <strong style="color:teal;">这是一段加粗的水鸭色文本</strong> (标记略复杂,不是很推荐)
    • 效果: 这是一段加粗的水鸭色文本

11.4.2 多彩斜体文本

  • 跟多彩加粗文本完全一样,只需把首尾的 ** 换成 * 即可
  1. 格式1: *<font color=teal>This is an italic teal text</font>*

    • 效果: This is an italic teal text
  2. 格式2: <font color=teal>*This is an italic teal text*</font>

    • 效果: This is an italic teal text

11.4.2 多彩粗斜体文本

  • 首尾换成 ***
  1. 格式1: ***<font color=teal>This is a bold italic teal text</font>***

    • 效果: This is a bold italic teal text
  2. 格式2: <font color=teal>***This is a bold italic teal text***</font>

    • 效果: This is a bold italic teal text

注意 多彩文本尽量慎用,Markdown 的核心就是 简洁精炼,注重 实质内容,而非花哨的 颜色样式

12. 拓展文本显示效果

  • 拓展显示效果既不是原生 Markdown语法 支持的,也非 HTML标记,而是部分编辑器 提供的 额外标识符,属于拓展语法,旨在为 Markdown使用者 提供更多样式选择
  • 不同编辑器,支持不一样,这里以 Typora编辑器 为例

12.1 文本高亮

  • 文本高亮 的格式:

    • ==这里是一段高亮文本==
  • 效果:

    • ==这里是一段高亮文本==

12.2 上标

  • 用一对 ^ 包裹 (Shift+ 6)

    • 格式: x^2^
    • 效果: x^2^
  • Obsidian 没效果的,可以用后面会讲的 Latex
  • 或者,也可以使用 HTML标记

    • <sup>这里是上标内容</sup>
    • X<sup>2</sup>
  • 效果:

    • X2

12.3 下标

  • 用一对 ~ 包裹 (Shift + `)

    • 格式: H~2~O
    • 效果: H~2~O
  • Obsidian 没效果的,可以用后面会讲的 Latex
  • 或者,也可以使用 HTML标记

    • <sub>这里是下标内容</sub>
    • H<sub>2</sub>O
  • 效果:

    • H2O

12.4 Emoji 符号

  • 用一对 : 包裹,里面是 Emoji 符号的 语义化文本 ( Typora编辑器 中,输入 : 就会带提示器 )

    • 示例:

      • :smile:
        :sweat:
        :cat:
        :woman_cartwheeling:
    • 效果:

      • :smile:
        :sweat:
        :cat:
        :woman_cartwheeling:
      • 补充:

        • 不支持上述方式的 MD编辑器或笔记软件,直接用 输入法 输入也是可以的

          • Windows系统 用户 win + . 就可以输入 Emoji 了

13. 转义字符

  • Markdown 中,我们 通过 标识符 改变 文本显示效果
  • 现在我们希望它不作为标识符,而是 作为字符本身呈现出来 (不具备改变文本显示效果的功能,只是一个普通字符)

    • 首先我们可以用前面介绍的 代码域 ,因为代码模式的显示效果就是源代码完全一致
    • 还有一种方法,可以利用转义字符,在这些标识符 前面 加上 反斜线 \ ( 反斜线要紧贴在标识符前面,不能空格 )

      • 原理:

        • \ 的作用是让标识符 转义 变为一个普通字符,完成这个效果后,反斜线会自动隐藏
        • 隐藏后的反斜线仅在源代码界面可见,在渲染界面不可见
        • 反斜线只争对标识符起作用,其他字符添加 \\ 不会自动隐藏
      • 补充:

        • 如果想给已经被加在标识符前面,会自动隐藏的 \ 显示出来,可以在反斜线前面再加一个 \ ,用它自己来转义自己

          • 示例: 这里紧跟在标识符前面的反斜线 \\*会被转义成普通字符显示出来,不会自动隐藏
          • 效果: 这里紧跟在标识符前面的反斜线 \*会被转义成普通字符显示出来,不会自动隐藏
  • 如何让被一对或多对 * 号 包裹的文本内容,能够正常显示 * ,且文本不改变格式

    • \*这段文本被一对星号包裹,但不会倾斜\*

      • 效果: *这段文本被1对星号包裹,但不会倾斜*
    • \*\*这段文本被2对星号包裹,但不会加粗\*\*

      • 效果: **这段文本被2对星号包裹,但不会加粗**
    • \*\*\*这段文本被3对星号包裹,但它既不倾斜也不加粗\*\*\*

      • 效果: ***这段文本被3对星号包裹,但它既不倾斜也不加粗***
  • 在表格中,使用 | 作为单元格的内容,但不会被识别为表格的结构,不会增加额外的单元格
|表头1|表头2||-|-||这里的文本被\|分隔|这里的文本也被\|分隔|
  • 效果:
表头1表头2这里的文本被\分隔这里的文本也被\分隔
  • 在行内代码中,让反撇号 ` 能被显示出来,有两种方法

    1. 首尾用两个引号包裹
      `` `显示2个反撇号` ```` `显示单个反撇号  ``

      • 效果: `显示两个反撇号` `显示单个反撇号
      • 注意 中间的内容 距离首尾引号 各有1个空格

    2. 之前提过,行内代码也可作为 突出显示的文本
      可以利用前面介绍的 键盘文本 + 转义符号 \ ,突出显示反撇号

      • 格式: <kbd>\`首尾的反撇号会正常显示\`</kbd>
      • 效果: `首尾的反撇号会正常显示`

网页链接显示文本内容 中,使用 中括号 [ ]

  • 在显示文本内容中,在其中一个中括号前面,加上转义符号 反斜杠 \

  • 引用一段话,一般会在换行之后,加上 - 出处
  • 因为 - 是标识符,会变成一个无序列表

如下所示:

The Web, the Tree, and the String.
写作之难,在于把网状的思考,用树状结构,体现在线性展开的语句里。

  • 史蒂芬·平克
  • 解决方法:

    • - 前面加上 转义符号 \
    >The Web, the Tree, and the String.
    >写作之难,在于把网状的思考,用树状结构,体现在线性展开的语句里。
    >\- 史蒂芬·平克   <!-- 加上转义符号 \ , 不会变成无序列表 -->
  • 效果:

The Web, the Tree, and the String.
写作之难,在于把网状的思考,用树状结构,体现在线性展开的语句里。
- 史蒂芬·平克

14. 空格&换行&强制删除

14.1 空格

  • 在一些编辑器或者支持MD的笔记软件里,无论你打多少个空格,它只会显示单个 空格 的距离

    • 可以使用 HTML中 空格字符实体 ——   (NBSP:“Non-Breaking Space” 的缩写)
    • 若要添加 多个 空格,就输入多个 ——        
  • 格式:

    • 这里有      6个空格分隔
  • 效果:

    • 这里有      6个空格分隔

14.2 换行

场景1:

  • 在一些编辑器或者支持MD的笔记软件里,无论你打多少个 回车,它只会显示单个 回车 的空行间距

    • 可以使用之前表格里提到的 <br> 标签,在 单独一行 中使用,增加额外的空行间距
    • 如果要增加 多个,就输入 多个 —— <br><br><br><br><br>
    • 注意 当单独一行使用 <br> 标签的时候,如果前后有标题标识符或者列表标识符,确保 br标签 前后两行都是空白行

  • 格式:
这里第一段文本<br><br><br><br><br>     <!-- 这里插入了5个空行间距 -->这里是第二段文本
  • 效果:
    这里是第一段文本


    这里是第二段文本

场景2:

  • 在列表中也可以插入换行符
- 这是一段无序列表  <br>     <!-- 插入一个空行间距,需单独一行,上下不用预留空格 -->  这是同一段无序列表中,空一行距离显示的内容- 这是第二段无序列表

效果:

  • 这是第一段无序列表


    这是同一段无序列表中,空一行距离显示的内容
  • 这是第二段无序列表
  • 补充:

    • 有一些MD编辑器或笔记软件,严格遵循MD的换行规则,你敲一个回车是没法换行的,必须在 行末2个空格,再按回车键

      • 格式:

        • 这里是一段想换行的文本空格 空格 Enter
          这是换行后的文本

14.3 强制删除

  • 很多编辑器都有英文标点自动补全功能,自动生成一对,光标落在中间
    只想删除前面1个,却会把 一整对 都删掉
  • 在多个列表的嵌套中,也许会遇到一些 无法被删除列表标识符
  • 解决方法:
    使用 Shift + Backspace 即可强制删除

    • Bcakspace   ( 退格键 )

15. 嵌入

  • 嵌入都是依赖 HTML标签 实现的,嵌入的都是在线链接格式

    • 如果是本地的,Obsidian 中音频是有自带的可录制的录音机插件的,其他的 音频、视频 直接复制黏贴就可以了,也可以直接拖拽到OB的笔记界面

      • 其他的媒体文件在 Obsidian 也和图片一样,是建了一个新的MD文件,以链接的格式引用在目标笔记中,用 ! 使它可见

15.1 嵌入音频

  • 格式:

    • <audio controls="controls" preload="none" src="音频链接地址"></audio>
  • 示例:
<audio controls="controls" preload="none" src="https://www.ldoceonline.com/media/english/exaProns/p008-001803372.mp3?version=1.2.37"></audio>
  • 效果:

15.2 嵌入视频

  • 格式:
<video width="600" height="420" controls>  <source src="movie.mp4" type="video/mp4">  <source src="movie.ogg" type="video/ogg">  <source src="movie.webm" type="video/webm">  </video>
  • 说明:

    • width ( 宽度 ) height ( 高度 ) ,可以自己设置,直接输入数字即可,单位默认是 px(像素)
      也可以使用 百分比
      width=100% 代表水平撑满整个窗口
      height=50% 代表垂直撑满半个窗口
    • Video标签 支持的视频格式 :MP4 ogg webm

--本文为转载--


  1. 周树人
  2. 绍兴人

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK