可能是相对路径的基准变了。预览与线上页面所在目录不同，图片或链接就可能指向另一处，应以最终发布地址核对。
- 找出使用相对路径的链接与图片。
- 按线上目录计算它们实际指向的位置。
- 发布前逐项验证目标，保留适合的路径形式。
注意：内容转换不会自动知道你的网站最终目录结构。
常见问题
全部常见问题 共 101 个问题
最近更新 · 每页 10 个
常见问题，快速找到答案
每页 10 个问题，点击展开答案；也可按右侧主题筛选。
01 Markdown预览正常，发布后链接为何不对？ 展开收起
参考来源：Markdown转HTML功能说明
02 Markdown转换结果能直接当完整网页吗？ 展开收起
通常不能。输出主要是正文片段，完整网页还需要文档结构、标题元信息及样式；预览区域的外观也未必与发布模板一致。
- 复制转换后的内容片段。
- 放入测试模板并加载实际使用的样式。
- 检查标题层级、列表以及图片大小。
注意：编辑器里的预览效果不是线上模板的最终保证。
参考来源：Markdown转HTML功能说明
03 XML和JSON互转后排版不同算失败吗？ 展开收起
不一定。两种格式表达结构的方式不同，缩进、属性位置和文本写法可能改变。应核对业务数据及顺序，而不是仅用逐字比较判断。
- 检查重复节点是否按预期变成列表。
- 对照属性、文本与混合内容的实际含义。
- 有顺序要求时在目标程序中验证读取结果。
注意：结构互换不保证原文每个空格都能无损往返。
参考来源：XML/JSON互转功能说明
04 XML转JSON出现带@的字段是什么意思？ 展开收起
这是转换规则用来区分属性与子节点的标记，不是原数据里突然多出的业务字段。读取输出时应按该工具的映射约定理解。
- 对照原标签中的属性名称和值。
- 在结果中查找带对应前缀的键。
- 传给其他程序前确认它采用相同映射。
注意：不同转换库可能使用另一套字段命名规则。
参考来源：XML/JSON互转功能说明
05 YAML含锚点时能直接用基础转换结果吗？ 展开收起
不宜直接依赖。页面采用的基础处理不保证覆盖锚点、别名和自定义标签等完整语法，复杂配置应交由目标系统认可的解析器复核。
- 先识别配置中是否存在引用或特殊标签。
- 用少量样本确认是否完整保留其含义。
- 在正式应用前使用完整解析实现校验。
注意：不要把没有报错理解为所有高级特性都已正确展开。
参考来源：YAML/JSON互转功能说明
06 YAML转JSON后前导零为什么消失？ 展开收起
未加引号的内容可能被推断为数字，前导零便不再作为文本保留。账号、编号等字段若需要原样保存，应明确使用字符串形式。
- 先区分该值是计算数字还是业务编号。
- 对文本编号加上合适引号后重试。
- 查看输出值的类型，而不只看显示内容。
注意：转换完成后还需遵守目标配置对字段类型的约定。
参考来源：YAML/JSON互转功能说明
07 XML能解析就代表通过XSD校验吗？ 展开收起
不能。基本解析只确认文档语法可接受，约束规定的节点顺序、类型和必填项还需要使用对应的模式文件另外验证。
- 先排除标签及属性的语法错误。
- 取得目标系统实际采用的模式版本。
- 按该版本检查结构和字段取值。
注意：格式化结果好看，不等于业务接收端会接受报文。
参考来源：XML格式化功能说明
08 XML格式化为何提示结束标签不匹配？ 展开收起
通常需要检查标签的嵌套顺序与名称大小写。外层尚未结束时，不能先关闭另一个层级；错误也可能来自前面遗漏了结束符。
- 从首次报错位置回溯到对应起始标签。
- 按由内到外的顺序核对每组闭合。
- 修正后重新解析，再检查下一个提示。
注意：排版缩进能帮助阅读，却不会自动修正结构含义。
参考来源：XML格式化功能说明
09 正则匹配整行内容应该怎样核对？ 展开收起
需要检查行首、行尾边界及多行选项，而不只是确认目标片段出现。能在字符串中找到一段合法字符，并不说明整段输入都符合规则。
- 准备一条正确样本和带多余前后缀的样本。
- 核对边界写法是否覆盖完整输入。
- 再用空行、换行和不应接受的文本验证。
注意：只测一个成功样本，很容易遗漏误匹配。
参考来源：正则测试功能说明
10 正则测试只找到第一个结果怎么办？ 展开收起
先核对是否启用了全局匹配选项。没有全局标志时，常见调用只取首次命中；同时也要排除表达式本身把后续文本一次吞入的情况。
- 用包含两处明确目标的短样本测试。
- 切换全局选项并观察匹配数量。
- 若仍只有一次，检查贪婪范围和边界条件。
注意：标志名称相同也不保证不同语言的匹配行为完全一致。
参考来源：正则测试功能说明
