个人Obsidian使用指南

见贤思齐

文章目录前言工具的选择下载与安装仓库推荐设定主题文件与链接同步及备份当前使用插件HideFoldersFileCleanerReduxAttachmentManagementobsidian-plugin-dynamic-tocMarkdownPrettifierimagetoolkit弃用或者被替代的插件网页剪藏Chrome插件MaoXian迁移从Joplin到Obsidian参考资料前言这篇文章是为了记录笔者自身的obsidian配置，同时也是为了推荐obsidian给新用户而写。通过少数派和V2EX社区了解到Markdown，很适合自己。初次接触Markdown语法的笔记软件是Typora，所见即所得，加上各种快捷键，基本不用记录语法即可编写文档，还可以转换为Word，PDF等文档。使用一段时间后，多了其他需求，第一点是笔记多了需要管理，第二点是一直没找到合适的移动端阅读和编辑的软件，第三点是同步和备份的需求。这个时候，我发现了Joplin，可以满足以上的需求，于是大部分文档用之管理。但是也发现一些使用上的问题。第一点是文档不是按.MD的文档形式存在。第二点是图片的管理，之前Typora是将图片存入.assets中保存，想分享他人源文件时候，可以方便打包给出。最近找到Obsidian这款软件，经过一番学习和研究后，虽然也存在一些问题，但是应该算目前最适合本人的笔记工具。工具的选择遵照以下的特点：本地化可迁移通用可搜索分享本地化字面意思，所有笔记文件都是保存在本地的，包括图片和附件。至于同步和备份，这就是建立在本地化之后考虑的事情，工具和办法都很多，只要数据在你手上。可迁移本人选择工具的一大前提是可迁移，就是以后不用这个工具了，迁移到新的工具是否方便。这一条要求下，任何国产云笔记都被排除了。之前接触过很多在线笔记，虽然可以方便的多端同步，但是如果想导出到其他同类工具会很麻烦，甚至不可能。比如某些在线笔记，导出文档是PDF格式。再举例，某些云笔记不能选择全部导出，即使导出的是PDF文档。基本算是不具备迁移性。通用即笔记文件本身是建立在通用的纯文本文件上，其他实现比如图片，超链接，文字的加粗和斜体等都是通过简单标记语法实现。这就是为什么选择MarkDown语法做笔记的原因。（虽然MarkDown语法本身也在演变，甚至不同软件部分语法不通用。）这里就解释了为什么不选RTF富文本，Word，PPT，甚至Excel来做笔记。可搜索即文本内文字可被搜索。在笔记文件是纯文本的基础上，实现可搜索性。分享这里包含两层意思，一层是可以将笔记分享给他人，一层是可以将笔记转换为其他通用格式比如Word，RTF，PDF等。Markdown文本文件可以通过Pandoc工具来实现。这里推荐Typora本身的导出功能，虽然也是通过Pandoc实现，但是方便快捷，导出PDF时候还可以用Typora的当前主题。下载与安装Download-Obsidian仓库新建仓库即在所选文件夹下创建仓库名同名的文件夹，并在其中生成.obsidian配置文件夹，当前仓库的配置和插件都保存在此文件夹下。打开本地仓库打开之前创建的仓库文件夹。推荐设定主题Typora-Vue文件与链接新建笔记本存放位置：当前文件所在文件夹内部链接类型：基于当前笔记的相对路径为了让Typora编辑器可以正确识别图片。在使用Typora编辑Obsidian里的文档时候，纯文字直接编辑，涉及图片或者附件，回到Obisian中插入。使用WiKi链接，不勾选。为了兼容Typora编辑器。附件默认存放路径：指定附件文件夹，attachments。为了搭配第三方插件AttachmentManagement使用。切换配置文件夹PC端默认即可。手机端，建议修改成.obsidianmobile，以作区分，因为部分插件可能不是多平台通用。同步及备份同步及备份，可以使用微软Onedrive网盘。在手机Android端，可以使用FolderSync做同步，缺点是略慢。有版本控制的需求，可以使用github或者gitee。在手机可以使用Mgit做同步。当前使用插件HideFolders隐藏特定文件夹，一般用于隐藏附件文件夹。FileCleanerRedux清理空文件，清理没被引用的附件。AttachmentManagement管理附件，主要是图片文件。设定如下：附件根目录，跟Obsidian设定一样。附件存储路径：${notename}.assets附件名称：IMG-${notename}-${originalname}obsidian-plugin-dynamic-tocTags·Aidurber/obsidian-plugin-dynamic-toc·GitHub设置外部渲染，与其他MarkDown通用目录语法格式。MarkdownPrettifier统一Markdown格式。可在YAML加入头部信息。imagetoolkit通过鼠标滚轮或点击工具栏缩放图标来放大或缩小图片通过鼠标拖拽或键盘方向按键（上、下、左、右）来移动图片支持全屏查看图片支持左旋、右旋、x轴翻转、y轴翻转图片支持实现图片的颜色反转支持拷贝图片弃用或者被替代的插件Localimageplus可以由AttachmentManagement插件替代。git按教程设置SSH免密，不能成功push。故改为使用GithubDesktop手动push。CopyImage已被imagetoolkit插件完美替代。只需右键单击图片，选择“复制图片”即可。这个插件提供了一个方便的方式来处理Obsidian中的图片，提升了用户的使用体验。网页剪藏Chrome插件MaoXian链接：MaoXianWebClipper(mika-cn.github.io)迁移从Joplin到Obsidian在Joplin中，选择全部导出，MD格式+文章前言。使用python脚本将Joplin的图片语法改为Markdown语法。将python脚本保存到Joplin导出的文件的根目录下。执行脚本。Joplin的图片格式是，改为Markdown的格式。importosimportre##来源：[如何从Joplin迁移笔记到Obsdian-疑问解答-Obsidian中文论坛](https://forum-zh.obsidian.md/t/topic/30037)#正则表达式匹配HTML的img标签，并捕获src属性的值img_regex=r']+src="([^"]+)"[^>]*>'##将HTML图片标签转换为Markdown格式defhtml_img_to_markdown(match):src=match.group(1)#returnf''returnf''#返回正确的格式#处理单个Markdown文件defprocess_md_file(file_path):withopen(file_path,'r',encoding='utf-8')asf:content=f.read()#使用正则表达式替换HTML图片标签为Markdown格式new_content=re.sub(img_regex,html_img_to_markdown,content)withopen(file_path,'w',encoding='utf-8')asf:f.write(new_content)#遍历目录并处理所有Markdown文件defprocess_md_files(directory):forroot,dirs,filesinos.walk(directory):forfileinfiles:iffile.endswith('.md'):file_path=os.path.join(root,file)process_md_file(file_path)#主函数defmain():#设置相对目录路径（相对于当前脚本所在的目录）relative_directory_path='./'#'./no'为相对路径，我这里将md文件全保存到了no文件夹下#获取绝对路径，以确保正确处理文件absolute_directory_path=os.path.abspath(relative_directory_path)#处理目录下的所有Markdown文件process_md_files(absolute_directory_path)print(f"AllMarkdownfilesin'{absolute_directory_path}'havebeenprocessed.")#如果脚本作为主程序运行，则调用主函数if__name__=='__main__':main()12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576初次发布时间：2024-07-0521:38:39参考资料Obsidian——Windows与安卓端双向同步-少数派(sspai.com)如何从Joplin迁移笔记到Obsdian-疑问解答-Obsidian中文论坛Obsidian插件：CopyImagePKMer_Obsidian插件：Imagetoolkit提供笔记中查看图片的基本操作