产品参数今天改一个尺寸，明天又补一条操作说明，如果每次都在网页和PDF里分别修改，很容易出现两个版本不一致。Markdown把内容保存在普通文本里，再生成适合阅读的输出，适合持续维护说明文档。
先定文档骨架，不急着调样式
打开XunL 在线Markdown编辑器，可以选择产品说明、采购询价、README或FAQ等起点，也可以从空白开始。模板是结构参考，其中示例参数不能替代真实产品资料。
以一份采购询价清单为例，用一级标题写文档名称，再用二级标题分出应用环境、已知参数、接口要求和待确认问题。清楚的层级能帮助接收者快速找到任务，不必把每一行都写成醒目的大标题。
用最小例子理解常用语法
输入 ## 安装前检查 可建立小节，后面用列表写“确认电压”“核对安装尺寸”等动作。参数适合表格，连续操作适合有序列表，程序或配置片段应放进代码块。表达方式随信息而变，不要把整篇说明都塞进一张宽表。
实时预览时逐项检查：标题顺序是否清楚，列表是否错误嵌套，代码是否被当成普通正文，链接文字是否说明去向。单换行处理和自动换行是不同选项，应按目标阅读习惯核对，不能只看编辑区换行就认为输出也一样。
图片引用也需要验证。加载文档图片是独立选项，接收者能否取得图片地址，取决于公开访问与目标环境。自己浏览器显示正常，可能只是缓存存在，不足以证明同事打开导出文件也有同样结果。
MD、HTML和打印文件，分别验收
MD保留可编辑内容，适合继续维护；HTML适合嵌入或发布文档，但导航、站点样式和权限是另外的工作。复制源码后，应在目标环境检查链接与结构，不能把一段文档HTML直接视为完成的网站。
需要PDF时使用打印流程，并检查实际分页。过宽表格可能挤压，长代码和网址可能溢出，标题还可能孤立在页尾。先缩减不必要列、拆分内容或调整组织，再重新打印；只看工作区预览不能替代成品检查。
交付时最好同时提供源MD与已经核对的阅读版本。文件名可以包含主题和版本，便于修改者知道从哪里继续，不必从截图重新录入。
语法支持范围，要在写作前了解
团队可以约定单位、参数缺失值和版本备注的写法。例如未知尺寸统一标成待确认，不用零替代；代码中的占位值清楚标注，避免接收者把演示配置复制到生产环境。这样的内容约定比统一字体更有助于减少误解。
编辑器支持常用Markdown子集，复杂嵌套、插件扩展和高级表格未必与其他平台相同。原始HTML会被当作文本而非任意脚本执行，因此不能用它承载所有网页交互。
如果最终要发布到另一平台，先用一小段包含表格、图片与代码的样本验证兼容，再写长文。共用设备上的本地草稿保存应按资料类型决定，含客户信息的内容还要遵守原有资料权限。
为什么在别的平台打开排版不同？
不同平台的解析器、扩展和样式可能不同。应围绕共同支持的语法写作，并以目标平台实际渲染为准，不把一个编辑器的预览当作所有平台标准。
能把复杂HTML组件直接粘进去吗？
原始HTML不会按任意组件运行。可以改用标题、列表、图片和代码等常用结构表达；确实需要交互时，应交给有相应发布能力的平台处理。
个人微信：ssevening
