I use a similar workflow using Pandoc at work.  I painstakingly re-created our corporate Word documentation templates using LaTeX and then set up Pandoc to generate documents from Markdown using these templates.<p>In addition to this, I used Haskell and Diagrams to produce DSLs for rendering various UML documents from text based descriptions.  These can be rendered in both vector graphics formats (SVG and Encapsulated Postscript) as well as a written description of the diagram that can be provided for accessibility reasons.<p>The big take-away I got out of this process was that I could write human-readable documents that were also machine-readable while also providing a higher level of accessibility for this documentation than would be possible using traditional WYSIWYG tools.<p>I highly recommend this style of documentation workflow.