乐于分享
好东西不私藏

插件稳定性全量测试文档

插件稳定性全量测试文档

插件稳定性全量测试文档

📖 NOTE

测试说明 本文档覆盖全部 Markdown 元素,用于测试 MoFa Publish 插件的渲染稳定性。 如发现渲染异常,请记录具体元素类型。

一、标题层级测试

H1 一级标题

H2 二级标题

H3 三级标题

H4 四级标题

H5 五级标题
H6 六级标题

二、段落与行内元素

这是一个普通段落。段落内容支持换行和多行文字,文字应当自动换行并保持良好的行间距。

这是粗体文字,写法为 **文字**

这是斜体文字,写法为 *文字*

这是粗斜体文字,写法为 ***文字***

这是删除线文字,写法为 ~~文字~~

这是行内代码,写法为反引号包裹

这是一段包含粗体斜体删除行内代码 混合的段落,测试行内元素共存时的渲染效果。

这是红色 HTML span 文字

这是蓝色粗体 HTML span 文字

这是放大字体的文字

三、列表

3.1 无序列表(单层)

  • 无序列表项 1
  • 无序列表项 2
  • 无序列表项 3

3.2 无序列表(嵌套)

  • 一级列表项 A 
    • 三级列表项 A-2-a
    • 三级列表项 A-2-b
    • 二级列表项 A-1
    • 二级列表项 A-2 
    • 二级列表项 A-3
  • 一级列表项 B 
    • 二级列表项 B-1
  • 一级列表项 C

3.3 有序列表(单层)

  1. 有序列表项 1
  2. 有序列表项 2
  3. 有序列表项 3

3.4 有序列表(嵌套)

  1. 第一步:准备工作 
    1. 运行 npm install
    2. 验证安装结果
    1. 检查环境变量
    2. 安装依赖包 
  2. 第二步:执行测试
  3. 第三步:查看报告

3.5 混合嵌套列表

  1. 第一项(有序) 
    • 孙项 1
    • 孙项 2
    • 子项 A(无序)
    • 子项 B(无序) 
  2. 第二项(有序) 
    • 子项 C

3.6 任务列表


  •  任务 1:已完成 ✅

  •  任务 2:已完成 ✅

  •  任务 3:进行中

  •  任务 4:未开始

  •  任务 5:已完成 ✅

四、引用块

这是一段简单引用。 微信公众号:墨发工具

这是多行引用。 第二行引用内容。 第三行引用内容。

粗体引用:这是包含粗体的引用块,测试行内格式在引用中的表现。

嵌套引用第一层

嵌套引用第二层

嵌套引用第三层

五、Callout(Obsidian 标注块)

📖 NOTE

普通说明 这是 NOTE 类型的标注,通常用于补充说明。

💡 TIP

小技巧 这是 TIP 类型的标注,适合展示最佳实践或小技巧。

⚠ WARNING

注意事项 这是 WARNING 类型的标注,用于警告潜在风险。

❗ IMPORTANT

重要信息 这是 IMPORTANT 类型的标注,标记关键信息。

🔥 CAUTION

危险操作 这是 CAUTION 类型的标注,用于高风险操作提示。

ℹ INFO

背景信息 这是 INFO 类型的标注。

✅ SUCCESS

操作成功 这是 SUCCESS 类型的标注。

❌ ERROR

错误提示 这是 ERROR 类型的标注。

六、代码块

6.1 无语言代码块

csharp1这是没有指定语言的代码块2publicclassExample {3publicstaticvoidmain(String[] args) {4        System.out.println("Hello, World!");5    }6}

6.2 JavaScript 代码块

javascript1// 防抖函数2functiondebounce(fn, delay) {3let timer = null;4returnfunction(...args) {5if (timer) clearTimeout(timer);6        timer = setTimeout(() => {7            fn.apply(this, args);8            timer = null;9        }, delay);10    };11}1213// 使用示例14const handleResize = debounce(() => {15console.log('窗口大小改变了!');16}, 300);1718window.addEventListener('resize', handleResize);

6.3 Python 代码块

python1import os2from pathlib import Path34deffind_markdown_files(root_dir: str) -> list[str]:5"""递归查找所有 Markdown 文件"""6    md_files = []7for path in Path(root_dir).rglob("*.md"):8        md_files.append(str(path))9returnsorted(md_files)1011if __name__ == "__main__":12    files = find_markdown_files(".")13for f in files:14print(f"Found: {f}")

6.4 Shell 代码块

bash1#!/bin/bash2# 一键部署脚本34echo"🚀 开始部署..."56# 安装依赖7npm install89# 编译构建10npm run build1112# 复制到目标目录13cp main.js manifest.json styles.css ~/.obsidian/plugins/mofa-publish/1415echo"✅ 部署完成!"

6.5 TypeScript 代码块

typescript1interfacePlugin {2idstring;3namestring;4versionstring;5onload(): Promise<void>;6onunload(): void;7}89classMofaPublishimplementsPlugin {10    id = 'mofa-publish';11    name = 'MoFa Publish';12    version = '1.0.0';1314asynconload(): Promise<void> {15console.log(`${this.name} v${this.version} 已加载`);16    }1718onunload(): void {19console.log(`${this.name} 已卸载`);20    }21}

6.6 JSON 代码块

json1{2"id":"mofa-publish",3"name":"MoFa Publish",4"version":"1.0.0",5"minAppVersion":"1.0.0",6"description":"将 Obsidian 笔记一键发布到微信公众号",7"author":"MoFa",8"authorUrl":"https://github.com/haha2345",9"isDesktopOnly":false10}

6.7 CSS 代码块

css1.mofa-article {2font-family: -apple-system, BlinkMacSystemFont, "PingFang SC", sans-serif;3font-size15px;4line-height1.8;5color#333;6padding20px;7}89.mofa-articleh2 {10font-size1.4em;11color#2F54EB;12border-left4px solid #2F54EB;13padding-left12px;14}

七、表格

7.1 基础表格

列 1
列 2
列 3
数据 A1
数据 B1
数据 C1
数据 A2
数据 B2
数据 C2
数据 A3
数据 B3
数据 C3

7.2 对齐方式表格

左对齐
居中对齐
右对齐
Apple
苹果
¥5.00
Banana
香蕉
¥3.00
Cherry
樱桃
¥15.00

7.3 复杂内容表格

主题名称
分类
特点
适用场景
📄 默认白
基础
简洁清爽
日常推文
🌙 暗夜
基础
深色背景
技术文章
🌸 樱花
优雅
粉色调
生活类
🤓 极客手稿
技术
网格+蓝色
开发笔记
🌊 深海
优雅
深蓝海洋
科技前沿

八、链接

8.1 外部链接

Obsidian 官网[1]

GitHub 仓库[2]

微信公众号平台[3]

8.2 行内链接写法

访问 Obsidian 文档[4] 了解更多插件开发信息。

8.3 带标题的链接

悬停查看标题[5]

九、图片

9.1 网络图片

9.2 带 alt 文字的图片

十、数学公式(LaTeX)

10.1 行内公式

爱因斯坦质能方程:

欧拉公式:

勾股定理:

复杂行内公式:

10.2 块公式

10.3 矩阵

十一、分隔线

十二、脚注

这是一段包含脚注的文字[1],脚注是补充说明信息的好方式。

Obsidian 是一款优秀的知识管理工具[2],支持双链和图谱视图。

MoFa Publish 插件[3]让内容发布更简单。

十三、HTML 直接嵌入

 这是居中的蓝色粗体段落 

 这是右对齐的灰色文字 

 居中段落测试 第二行内容 

十四、综合混排测试

坑位 1:文件权限冲突

🔥 CAUTION

高危操作 以下命令会修改系统文件权限,请在充分理解后执行。

由于代码库穿梭在 macOS 和黑群晖 NAS 之间,两个系统底层的用户权限机制不同,导致底层触发 permission denied 报错。

解决步骤:

  1. 打开 Syncthing 控制台,点击高级
  2. 勾选 Ignore Permissions(忽略权限)
  3. 重启同步进程验证效果
bash1# 查看当前权限2ls -la ~/Documents/myVault/34# 递归修复权限(谨慎执行)5chmod -R 755 ~/Documents/myVault/

💡 TIP

推荐配置 推荐在 .stignore 文件中添加以下规则,精准隔离临时文件:

jboss-cli1//.stignore 配置示例,强烈建议加上2(?d).obsidian/workspace.json3(?d).obsidian/workspace-mobile.json4(?d).DS_Store5*~6*.tmp

效果对比:

配置前
配置后
频繁同步冲突
零冲突
大量临时文件
干净整洁
权限报错
正常同步

十五、Obsidian Wiki 链接(图片)

(以下图片测试需要 vault 内有对应文件,可替换为实际图片文件名)

十六、特殊字符与转义

反引号:`

星号:*

下划线:_

方括号:[

井号:#

反斜杠:\

HTML 实体:& < > © ™

测试检查清单

📖 NOTE

测试完成后请逐项验证 对比插件预览和实际效果,记录不符合预期的项目。


  •  H1-H6 标题层级显示正确

  •  粗体/斜体/删除线显示正确

  •  行内代码样式正确

  •  单层无序列表符号显示(●)

  •  嵌套无序列表符号层级(●→○→■)

  •  有序列表编号正确

  •  任务列表复选框显示

  •  代码块深色背景 + Mac 三色圆点(极客主题)

  •  代码高亮颜色正确

  •  表格边框和对齐正确

  •  Callout 背景色和边框颜色正确

  •  行内公式  渲染正确

  •  块公式独立居中显示

  •  脚注跳转正常

  •  外部链接可点击

  •  图片显示正常(网络图片)

  •  分隔线显示正确

  •  HTML 内嵌样式生效

🔗 参考链接

[1] Obsidian 官网: https://obsidian.md

[2] GitHub 仓库: https://github.com/haha2345/obsidian-mofa-publish

[3] 微信公众号平台: https://mp.weixin.qq.com

[4] Obsidian 文档: https://docs.obsidian.md

[5] 悬停查看标题: https://obsidian.md “Obsidian – Sharpen your thinking”

  1. 这是第一个脚注的内容,可以包含详细的补充说明。 ↩

  2. Obsidian 官网:https://obsidian.md,支持 Windows、macOS 和移动端。 ↩
  3. MoFa Publish 仓库:https://github.com/haha2345/obsidian-mofa-publish ↩