背景
我有几个朋友教我markdown
写pandoc
文档。在我目前的工作中,我们使用微软 Word用于为我们的最终用户编写非结构化的一次性操作文档。出于以下原因,我想开始用 markdown 编写它们。
- 内容与结构的分离。
- 使用变更控制系统跟踪更新的能力
- 建立一个标准模板,其中包括徽标、样板公司文本以及所有后续文档通用的布局。
我想创建一些模板,让所有文档都包含相同的信息流供用户使用。目标是为我们的 IT 部门用户文档增添专业外观。
我认为公司托管的 wiki 可能就足够了,但是决策者目前不会允许这样做。
问题
我需要的是添加徽标等元素以及可以添加到 HTML 或 PDF 模板的标准文本方面的帮助。此外,我还想定义宏,例如将单词封装在!
感叹号中会根据一组规则突出显示该单词,例如键盘上的按键或软件 GUI 的按钮。相反,将单词封装在&
& 符号中会更改样式以表示 GUI 菜单元素的名称。