<div id="header">
<h1 class="title">My Document Creation workflow using Markdown and Pandoc</h1>
<h2 class="author">b-yeezi</h2>
</div>
<h1 id="show-notes">Show Notes</h1>
<p>I write almost exclusively in Markdown <a href="https://daringfireball.net/projects/markdown">https://daringfireball.net/projects/markdown</a> when writing documents and taking notes. I use the program, Pandoc <a href="https://www.pandoc.org">https://www.pandoc.org</a> to convert markdown to different formats, including odt, docx, and pdf.</p>
<p>The original purpose of Markdown: <a href="#fn1" class="footnoteRef" id="fnref1"><sup>1</sup></a> &gt; Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).</p>
<p>Markdown has since been extended to include more features and functionality. Extended versions include Github-flavored markdown <a href="https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet">https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet</a> and multi-markdown <a href="https://fletcherpenney.net/multimarkdown">https://fletcherpenney.net/multimarkdown</a>.</p>
<p>Some of the basic syntax:</p>
<ul>
<li>Headings - use one or more <code>#</code> to make headings</li>
<li>bold - use <code>__</code> or <code>**</code> for bold</li>
<li>italics - use <code>_</code> or <code>*</code> for italics</li>
<li>hyperlinks - use <code>[text](link)</code> for hyperlinks</li>
<!-- <li>images - `<img src="link" alt="alternative text" /> for images</li> -->
<li>images - <code>![text](link)</code> for images</li>
<li>tables - <pre><code>Head1 | Head2 | Head3</code><br/><code>----- | ----- | -----</code><br/><code>stuff | stuff | stuff</code></pre></li>
<li>lists - use <code>-</code> or <code>*</code> or <code>+</code> at the beginning of a line</li>
<li>quotes and code - ` for single code item, <code>&gt;</code> for block quote, tab for block code, ``` for fenced code. Highlighting is available</li>
</ul>
<p>Pandoc: <a href="#fn2" class="footnoteRef" id="fnref2"><sup>2</sup></a> Pandoc can convert documents in markdown, reStructuredText, textile, HTML, DocBook, LaTeX, MediaWiki markup, TWiki markup, OPML, Emacs Org-Mode, Txt2Tags, Microsoft Word docx, EPUB, or Haddock markup to</p>
<ul>
<li>HTML formats: XHTML, HTML5, and HTML slide shows using Slidy, reveal.js, Slideous, S5, or DZSlides.</li>
<li>Word processor formats: Microsoft Word docx, OpenOffice/LibreOffice ODT, OpenDocument XML</li>
<li>Ebooks: EPUB version 2 or 3, FictionBook2</li>
<li>Documentation formats: DocBook, GNU TexInfo, Groff man pages, Haddock markup</li>
<li>Page layout formats: InDesign ICML</li>
<li>Outline formats: OPML</li>
<li>TeX formats: LaTeX, ConTeXt, LaTeX Beamer slides</li>
<li>PDF via LaTeX</li>
<li>Lightweight markup formats: Markdown (including CommonMark), reStructuredText, AsciiDoc, MediaWiki markup, DokuWiki markup, Emacs Org-Mode, Textile</li>
<li>Custom formats: custom writers can be written in lua</li>
</ul>
<p>I use Ubuntu because it is the only distro that does not bundle pandoc in the haskell libraries. With pandoc, you can specify the template that you are using, so that the same one document can be formatted quickly in many different ways and file formats.</p>
<p>Workflow:</p>
<ol style="list-style-type: decimal">
<li>Write using vim or other text editor. When I was starting, I used a markdown previewer</li>
<li>Create the template for the client</li>
<li>Convert document appropriately</li>
</ol>
<p>Use markdown for:</p>
<ul>
<li>taking notes</li>
<li>creating SOPs</li>
<li>Creating User guides (Image Magick mogrify)</li>
<li>Creating things for my website</li>
</ul>
<p>Other programs and tools:</p>
<ul>
<li>Retext</li>
<li>Haroopad</li>
<li>discount</li>
<li>stackedit.io</li>
<li>atom</li>
<li>texlive for going direct to pdf</li>
</ul>
<div class="footnotes">
<hr />
<ol>
<li id="fn1"><p>from <a href="https://daringfireball.net/projects/markdown">https://daringfireball.net/projects/markdown</a><a href="#fnref1">↩</a></p></li>
<li id="fn2"><p>from <a href="https://www.pandoc.org">https://www.pandoc.org</a><a href="#fnref2">↩</a></p></li>
</ol>
</div>
