TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: Markdown to PDF From:Ryan Young <ryangyoung -at- gmail -dot- com> To:Serdar Ozmen <serdar -dot- a -dot- ozmen -at- gmail -dot- com> Date:Thu, 19 Feb 2015 18:41:14 -0800
Serdar, that tool sounds very promising--exactly what I'm looking for.
Would you be able to provide a link?
On Wed, Feb 18, 2015 at 11:05 PM, Serdar Ozmen <serdar -dot- a -dot- ozmen -at- gmail -dot- com>
wrote:
> Hi Ryan,
> I am using MarkDown, too. When Pandoc is used with the BeautifulDocs tool,
> the PDF seems fine. You can install and have this tool inserted into the
> PDF generation by the engineers, and play with it.
>
> On Thu, Feb 19, 2015 at 8:40 AM, Mark Giffin <mgiffin -at- earthlink -dot- net>
> wrote:
>
>> My understanding is that LaTex is pretty capable with formatting. Are you
>> sure you are finding the right docs to tell you how to do it?
>>
>> But if that doesn't work, you could use Pandoc to output to DocBook XML.
>> Then you can use the DocBook output toolchain (free) to get a lot of
>> control over it. If you really need to get picky with the PDF you can get
>> into modifying the XSL-FO that is produced, but that might be more than you
>> want to get into. The free XSL-FO processor (Apache FOP) is not as good at
>> some things as one of the commercial FO processors (mainly Antenna House or
>> RenderX XEP).
>>
>> Or you could output to HTML and then use CSS and a formatter like
>> PrinceXML (commercial) to create PDF. You might need to use some
>> proprietary PrinceXML CSS stuff to get certain formatting effects because
>> CSS is not as capable as XSL-FO (not yet anyway).
>>
>> Mark Giffin
>> Mark Giffin Consulting, Inc.
>> http://markgiffin.com/
>>
>>
>> On 2/18/2015 8:56 PM, Ryan Young wrote:
>>
>>> Hello,
>>>
>>> At my new job, what documentation there is is in Markdown. The engineers
>>> set up a script using pandoc to create some functional PDF output. The
>>> problem is that pandoc requires LaTex to produce the PDF, which doesn't
>>> give me very much control of things like the location of images in the
>>> document (or the ability to create links).
>>>
>>> I've played around with Atom and SublimeText, but neither gives me all
>>> that
>>> much more control over the PDF output. I've also suggested the company
>>> start using Confluence, which would solve the problem, but it seems like
>>> that will take a bit of planning.
>>>
>>> Any suggestions?
>>>
>>>
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>> Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy &
>> Procedure Guides, eBooks, and more using Microsoft Word |
>> http://bit.ly/doctohelp2015
>>
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>
>> You are currently subscribed to TECHWR-L as serdar -dot- a -dot- ozmen -at- gmail -dot- com -dot-
>>
>> To unsubscribe send a blank email to
>> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>>
>>
>> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
>> http://www.techwhirl.com/email-discussion-groups/ for more resources and
>> info.
>>
>> Looking for articles on Technical Communications? Head over to our
>> online magazine at http://techwhirl.com
>>
>> Looking for the archived Techwr-l email discussions? Search our public
>> email archives @ http://techwr-l.com/archives
>>
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015