VSCODE 编辑markdown 文件
因为Obsidian版权问题,改用vscode编辑器 编辑markdown 文件
1.使用VSCODE 编辑markdown 文件
首先分别下载 Markdown 和markdown PDF 第三方插件
2.保存文件为md 格式,
如果需要缓存图片,可以点击右上角的预览模块。就可以看图片了
(window 和linux 服务器都是/ 分隔符)
如果是图片,就是如下:
![](./a.jpg)
3.Markdown 编辑器使用
3.1.文件保存为md(markdown) 格式。
3.2.左侧窗体编辑源码,如果需要预览最终文件,点右上角的预览模块。就可以看图片了
3.3 如果预览没问题的话,直接在左侧窗体点右键 即可 export to pdb 保存PDF
########sample 1 Markdown常用语法
# 1. 标题
标题使用`#`来标识,符号与内容之间需要一个空格,N级标题使用N个`#`,在需要成为标题的行最左侧使用`#`即可使该行成为标题。
例如:
# 一级标题
## 二级标题
### 三级标题
___
# 2. 加粗
加粗使用一对`**`来标识,在需要加粗的内容左右各添加一个`**`即可加粗。
例如:
**加粗一整句。**
仅加粗**这里**。
___
# 3. 斜体
斜体使用一对`*`来标识,在需要斜体的内容左右各添加一个`*`即实现斜体。
例如:
*这一整句都要斜体。*
仅仅*斜体*这两个字。
___
# 4. 删除线
删除线使用一对`~~`来标识,在需要显示删除线的内容左右各添加一个`~~`即实现内容删除线。
例如:
~~删除这一整句。~~
仅仅删除~~最后几个字~~。
___
# 5. 列表
列表有两种,有序列表和无序列表。
## 1. 有序列表
有序列表使用`n.`来表示,符号与内容之间需要一个空格,在需要的列表内容最左侧添加符号即可使该行内容成为列表项,第N项就用`N.`。
例如:
1. 第一条使用`1.`。
2. 第二条使用`2.`。
## 2. 无序列表
无序列表使用`*`或`-`来标识,符号与内容之间需要一个空格,在需要的列表内容最左侧添加符号即可使该行内容成为列表项。
例如:
* 第一条
* 第二条
___
# 6. 区块
区块使用`>`来标识,符号与内容之间需要一个空格,N级区块使用N个`>`,在需要标记为区块的内容最左侧添加符号即可使该行成为区块内容。
例如:
> 这是一个一级块。
>> 这是他的子块。
>>> 这是三级块。
> 但是这是新的一块。
___
# 7. 分割线
分割线使用`___`来标识,在需要分割线的地方,在单独一行使用该符号即可。
例如:
上文。
___
下文。
___
# 8. 链接
链接需要两个符号,分别是`[]`来标识显示的内容以及`()`来标识访问的链接。
## 1. 显示内容
显示的内容用`[]`符号来包裹,形如`[这是显示内容]`。
## 2. 访问链接
访问的链接用`()`符号来包裹,形如`(这是访问链接)`。
例如:
* *[这是访问百度的链接](https://www.baidu.com/)。
* 或者点击[这里](https://www.apple.com/)访问苹果官网。
___
# 9. 代码
代码分为代码片段和代码块两种格式。
## 1. 代码片段
代码片段使用``` `` ```来包裹,在需要代码格式的内容左右各添加一个``` ` ```即可使中间的内容成为代码。
例如:
`x = y + 1`
`x := y + 1`
## 2. 代码块
代码使用` ``` `来标识,在需要代码格式的内容上下各添加一行单独的` ``` `即可使中间的内容成为代码,如果需要代码格式高亮,在上方的` ``` `后面紧跟代码语言名称即可。
例如:
```Python
#! /usr/local/bin/python3
import os
print(os.getcwd())
```
```Go
package main
import "fmt"
func main() {
fmt.Println("hello.")
}
```
___
# 10. 任务列表
任务列表使用`- [ ]`来标识,符号与内容之间需要一个空格,在需要标记为任务的内容最左侧添加符号即可使该行成为一个任务项;如果需要标记为已完成,可以在`[ ]`中添加任意字符,形如`[.]`即可,如果需要标记为已完成同时添加删除线,则需要使用`[X]`来标识。
Obsidian中可以使用快捷键```cmd+L``` 来直接创建一个任务项或是切换其状态,并且可以通过点击左侧的框来切换该项并为该项添加删除线。
例如:
- [ ] 这是一个未完成的任务。
- [.] 这是一个已完成的任务。
- [x] 这是使用鼠标完成的任务。
- [x] 这是完成并添加删除线的任务。
___
#######sample2 Obsidian使用方法
# 1. Obsidian概况
## 1.1. 简介
Obsidian是一款以**Markdown**文档为内容主体的知识整理软件,由于其方便的**双链**功能,在一定程度上是鼓励用户去做知识梳理、知识输出而非简单的知识收集、收藏。
Obsidian还有很好的跨平台性,是一个WEB技术的软件,在多种操作系统上均可使用,且支持诸多插件。
此外,Obsidian并不需要联网,所有的数据都是本地化的,除非你需要其官方的同步或发布服务,这在一定程度上对数据安全敏感的用户是一种吸引。
## 1.2.概念
### 1.2.1. 文档结构
Obsidian的文档就以文件夹嵌套文件夹的方式存储,由一个最大的文件夹,称作**数据库**,打开这个文件夹后,其中的子文件夹和文件都会以树形结构显示出来。在Obsidian中创建的文件夹或文件也可以在系统的文件管理器中找到。
### 1.2.2. .obsidian
Obsidian的配置会随着数据库而存在,配置的内容存储在数据库的 **.obsidian**文件夹下,如果需要迁移配置,则需要对该文件夹进行复制。
### 1.2.3. .trash
Obsidian也内置了对数据库的回收站文件夹,可以设置删除的文档或文件夹移动到Obsidian回收站,而非直接删除,这样可以方便文档的找回。
`设置(Settings)->文件和链接(Files & Links)->删除文件设置(Deleted files)->移至软件回收站(.trash文件夹)`
## 1.3. 操作注意
### 1.3.1. 实时预览(Live Preview)
该功能可以在编辑模式下预览文档解析后的状态,推荐开启。
`设置(Settings)->编辑器(Editor)->默认编辑模式(Default editing mode)-实时预览(Live Preview)`
### 1.3.2. 核心插件(Core Plugins)
录音机(Audio recorder)、书签(Bookmarks)、白板(Canvas)、出链(Outgoing Links)、反向链接(Backlinks)等重要功能需要在核心插件开启。
`设置(Settings)->核心插件(Core Plugins)->@功能开关-@功能开关`
### 1.3.3.插件(Community plugins)
关于主题或其他额外的开源插件,需要存放在数据库的.obsidian文件夹下的.plugins文件夹中。
### 1.3.4.默认存储位置
Obsidian中可以设置新文档、新附件的默认存储位置,设置后可以比较方便地管理新文档和新附件。
`设置(Settings)->文件和链接(Files & Links)->@默认存储设置-@路径设置`
___
## 1.4. \*教程视频
[Obsidian教程视频——清单控沙牛](https://www.bilibili.com/video/BV1H44y1n71k)
___
# 2. Markdown语法
![[Markdown常用语法]]
___
# 3. Obsidian独特功能
^feature
## 3.1. TAB解析
Markdown文档原生对TAB的解析仅仅是根据HTML解析规则进行,而在Obsidian中,可以将没有其他语法的TAB解析为一个小区块,类似`>`语法的效果,是一个较为方便的快捷分块语法。例如:
区块1
区块2
区块1
此外,在列表中,也会将TAB解析为额外的缩进列表,快速地重新编号,完成多级列表的编写。例如:
1. 条目1
2. 条目2
1. 子条目2.1
1. 子条目2.1.1
## 3.2.双链
^157495
双链的存在,使得Obsidian中的各个文档不再孤立,而是可以存在相互关联,通过建立文档链接,把不同的文档、文本片段串起来,形成知识网络。
系统性的知识往往是网状的,而非孤立的,传统文本文档就是孤立的,也许在一些文档格式中可以通过附件等方式进行小幅度的文档关联,但一旦关系变得复杂起来便无能为力了。Obsidian采用文档链接的方式,将旧有的知识片段链接到新的知识学习记录中,这会让用户在知识的学习和输出中就意识到不同知识片段之间的关联,从而激发用户对知识的网状记忆。
在Obsidian中建立链接,是通过`[[]]`语法,形如`[[链接内容]]`,即可将需要链接的内容链接在文档中显示,例如:
[[Obsidian使用方法]]
这样的链接,会显示出要链接的内容标题,若需要显示自定义文本,可以通过`|`语法来实现类似Markdown链接的效果,形如`[[链接内容|显示文本]]`,例如:
[[Obsidian使用方法|链接内容]]
若要链接一个文档的某个**片段**,则需要使用`^`语法,形如`[[链接文章^链接片段]]`,例如:
[[Obsidian使用方法#^157495]]
这样的片段链接会产生一个**片段ID**,注意,**若改动了这个ID,使得链接ID与片段ID不一致,则会使链接失效**。我们也可以自己手动在某个片段添加ID然后进行链接,例如:
[[Obsidian使用方法#^feature]]
此外,我们当然可以对上述的这几个语法进行融合,链接到某个片段并显示一个自定义文本,例如:
[[Obsidian使用方法#^feature|Obsidian特性]]
最后,当我们建立了链接之后,也在设置中开启了关系图谱插件,那么我们就可以在关系图谱功能中查看文档之间链接的可视化模型,例如:
![[Pasted image 20231031232717.png]]
___