Obsidian 插件:CommonMark Live Preview

Obsidian 插件:CommonMark Live Preview

插件名片

  • 插件名称:CommonMark Live Preview
  • 插件作者:lruijsink
  • 插件说明:Make Live Preview render Markdown the way CommonMark does: soft line breaks as spaces and nested lists with any valid indent, without touching your files. - This plugin has not been manually reviewed by Obsidian staff.
  • 插件分类:[‘文字处理’, ‘编辑工具’, ‘界面优化’, ‘obsidian插件’]
  • 项目地址:点我访问
  • 国内下载地址:下载安装
  • 自述文件:Readme

概述

CommonMark Live Preview 旨在解决 Obsidian 实时预览模式下 Markdown 渲染与 CommonMark 标准不一致的问题。它通过调整编辑器内的显示逻辑,将段落中的软换行符渲染为空格,并将嵌套列表的缩进统一显示为每层 4 个空格。这种处理方式仅改变视觉呈现,不修改磁盘上的原始文件内容,确保你的笔记格式始终符合 CommonMark 规范,同时兼容现有的格式化工具。

典型场景包括处理长段落和复杂列表。例如,当你在文件中手动将段落折行至 80 列时,普通编辑器会显示双重换行,而该插件会将这些行合并显示为单行,由编辑器自动处理视觉换行。又如,在编写嵌套列表时,无论你在文件中如何缩进,编辑器都会以标准的 4 空格层级清晰展示,避免了因缩进不规范导致的列表结构混乱,让阅读和编辑体验更加直观。

相比其他仅负责自动换行或格式化的插件,其核心特色在于“显示与存储分离”。它不会主动修改文件内容,而是维护一份磁盘文本与编辑器文本的映射关系。当配合 Obsidian 内的格式化插件使用时,它能智能拦截格式化后的全文替换操作,确保编辑器视图平滑更新,避免光标跳动或内容闪烁。此外,它支持通过 Frontmatter 对特定文件禁用此功能,提供了灵活的局部控制能力。

使用前需注意,由于 Obsidian 的搜索功能基于磁盘内容,跨越软换行的短语可能无法被完整匹配。此外,编辑过的行在保存后会以编辑器显示的长行形式写入磁盘,直到你运行外部格式化器才会重新折行。该插件不适合那些希望插件自动处理文件换行或缩进的用户,也不适用于依赖 Tab 键缩进或块引用内特殊缩进逻辑的复杂文档结构。

Help

这篇插件文章还没有人贡献,欢迎占坑!
如果您有好的想法欢迎提交PR或者文末留言。




反馈交流

QQ群

微信群 Pkmer微信群


其他渠道

版权声明