Empowering Writing with Markdown

I’ve long been a writer, but writing and publishing have been challenging. Pencil or pen and paper and then endless sheets of paper for rewrites. My writing took off when my parents sent me to college with a typewriter. Lots paper and ink were used, but the writing process became easier. Then came word processing. What a gift to be able to write, revise and rewrite without killing anymore trees or using more ink.

My journey with word processing began with FredWriter and AppleWorks. These tools allowed me to write with ease, highlight text, and cut or copy and paste. The ability to save changes to disk for later use was a game-changer. As time passed, I encountered MacWrite, MaxWrite, Microsoft Word, StarOffice Writer, Libreoffice Writer, and many more. Each new tool brought with it an evolution in the writing process, making it better yet more complex, a journey that never ceased to intrigue me.

Most of the writing I do is for the web and it’s not easy to convert from from Writer or Word to HTML. But it does not have to be that way because in 2004 John Gruber created Markdown. Finally a writing format easily accessible to all that can be created in the most inelegant text editor yet transformed into beautiful written content for the web. Markdown is easily mastered and could be taught to students as early as third grade.

In addition to providing an easily accessible word processor at minimal cost, students can also be introduced to the basics of programming. Markdown converts plain text into structured HTML, making it a simple tool for creating complex documents that can be easily shared with teachers and fellow students.

Markdown’s versatility is a game-changer, making it accessible to everyone, including students with varying technical skills. With a minimal learning curve, students can quickly start using Markdown to format text, create lists, insert links, and embed images. The fact that Markdown can be shared across various platforms, from mobile phones to PCs, regardless of the operating system, empowers students to use it for a wide range of tasks, from note-taking to essay writing and presentation creation. 

Learning Markdown also increases students digital literacy  by familiarizing them with basic concepts of markup languages and text formatting. It bridges the gap between plain text and more complex coding languages providing a foundation for further learning and web development.  Platforms like Github and Gitlab rely on Markdown for documentation. Markdown is used in scientific documentation and most of the output from ChatGPT, Microsoft CoPilot and other LLMs is provided in Markdown format. 

You don’t need a wordprocessor to create Markdown. You can use Wordpad on Windows, TextEdit on MacOS, gedit or vim on Linux. You will need to use the following tags and save your work with the .md file extension.

Headers:

# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6

Emphasis:

*Italic* or _Italic_
**Bold** or __Bold__
***Bold and Italic*** or ___Bold and Italic___

Lists:

Unordered lists:

- Item 1
- Item 2
  - Subitem 1
  - Subitem 2

Ordered lists:

1. First item
2. Second item
   1. Subitem 1
   2. Subitem 2

Links:

[Link Text](http://url.com)

Images:

![Alt Text](http://url.com/image.jpg)

Block quotes:

> This is a blockquote.

Code:

Inline code`code block`
Code block: 3 back ticks on the line before the code and three back ticks on the line after the code. 

Horizontal rule:

---

For more information on formatting be sure to consult this excellent guide on Github. Happy writing!

Enhancing My Resume with AI: A Journey with Microsoft Copilot

A few days ago a friend sent me a message about an opportunity to work as a Maker Space coach at a local university. After discussing the opportunity with my wife she suggested I apply. I completed the online application and then toward the end of the process i needed to submit a resume. There used to be a way to use your Linkedin profile to generate a resume. They don’t offer that service anymore. I am a Canva subscriber and there is an appllication that is supposed to work but alas it wasn’t working tonight. I asked ChatGPT to create a resume with the link to my LinkedIn profile. ChatGPT won’t perform this. That’s when I tried Microsoft Copilot.

I asked Copilot if it could help me create a resume. It suggested that I drag and drop my resume into the conversation space. I searched my drive and found a resume I had written seven years ago for a graduate school application. It was a PDF. Copilot would not work with the PDF but suggested that I could use a JPG or PNG. I opened the resume document and took a screen picture of it and saved the file as PNG. Then I uploaded it to Copilot. I just a few seconds Copilot read my resume and printed it out on the display. Using Copilot I instructed it to add the new additions and corrections to my resume and it did a wonderful job of that. It was incredibly easy.

Copilot provides all of it’s output in Markdown. I decided to convert the Markdown to PDF so I copied and pasted the output into my favorite MarkText which is my favorite Markdown editor, saved the file and then exported it to a PDF. I uploaded the PDF with my application and submitted it. If you find yourself in a situation like I did tonight I suggest you try using Microsoft Copilot and open source tools like Screenshot on Linux Mint and Marktext

Pandoc: The Ultimate Document Conversion Tool

Pandoc is a versatile command-line tool that facilitates seamless file conversions between different markup formats. It supports an extensive range of input and output formats, making it indispensable for writers, researchers, and developers. I have found it particularly useful when converting output from LLMs to to HTML or more common word processing formats.

Pandoc’s strength lies in its support for various input formats, including Markdown, HTML, LaTeX, Open Document, and Microsoft Word. It can convert those documents to PDF, HTML, EPUB, and even PowerPoint presentations. This flexibility makes Pandoc an invaluable tool for individuals working with documents across different platforms and tools.

Here are some specific examples that may fit your use case.

1. Converting Markdown to HTML:

Markdown, known for its simplicity and readability, is widely used for creating content for the web. With Pandoc, you can effortlessly convert Markdown files to HTML, enabling seamless web content publishing. For instance, the following command can be used to convert a Markdown file named “example. md” to HTML:

$ pandoc example.md -o example.html

2. Generating PDF from LaTeX:

LaTeX, renowned for its powerful typesetting capabilities, is favored for academic and technical documents. Pandoc seamlessly converts LaTeX files to PDF, producing high-quality documents suitable for printing or digital distribution. Consider the following command to convert a LaTeX file named “paper.tex” to PDF:

$ pandoc paper.tex -o paper.pdf

3. Transforming Word documents to Markdown:

Many writers and researchers prefer working with Markdown due to its simplicity and portability. With Pandoc, you can convert Microsoft Word documents to Markdown, allowing editing and collaboration using lightweight, text-based tools. Use the following command to convert a Word document named “report.docx” to Markdown:

$ pandoc report.docx -o report.md

4. Creating EPUB from HTML:

EPUB, a popular e-book format compatible with a wide range of e-readers and mobile devices, is a common choice for digital content distribution. If you have content in HTML format, Pandoc can assist in converting it to EPUB for convenient distribution and reading. Here’s an example command to convert an HTML file named “book.html” to EPUB:

$ pandoc book.html -o book.epub

5. Convert Markdown file to a PowerPoint presentation using Pandoc, you can use the command

$ pandoc myslides.md -o myslides.pptx

You can open the resulting .pptx file in PowerPoint

In addition to these examples, Pandoc offers extensive customization options for fine-tuning the output of document conversions. Users can specify styling, metadata, and other parameters to ensure the converted files meet their specific requirements.

In conclusion, Pandoc stands as a robust and versatile tool for document conversion, offering support for a wide array of input and output formats. Pandoc can help streamline your workflow and enhance your document management capabilities, whether you’re a writer, researcher, or developer.

Seamlessly Convert Your Markdown Docs to Office Formats Using Pandoc

I have been experimenting a lot with Ollama and other artificial intelligence tools and the anwers to my prompts always are rendered in Markdown. I have Marktext on my Linux computer and MacDown on my MacBook Air so I can easily copy and paste the output into either of those editors and save it as a Markdown file on my computer. However, when I want to share those files with colleagues who are unfamiliar with Markdown I need a way to convert those files into a format that’s easily accessible for them. My Markdown editors can only export the Markdown files as HTML or PDF.

That problem is easily solved with Pandoc which is a great tool that anyone can install on Linux, MacOS or Windows that easily converts Markdown into any number of different formats. Easily install Pandoc on Linux with the following commands:

$ sudo dnf install pandoc
or 
$ sudo apt install pandoc

On MacOS use Homebrew to easily install Pandoc by opening a terminal and entering the following command.

$ brew install pandoc

You can install Pandoc on Microsoft Windows using Chocolatey with the following command:

choco install pandoc

Once the application is installed it works very well from the command line. The project mainains great documentation. I needed to convert a Markdown document to .docx so my Windows using colleagues could easily read the output from the LLM I had been using. I used the documentation and the programs man page on my Linux system to enter the following command.

$ pandoc -o ProposedLease.docx -f markdown -t docx LeaseReview.md

The conversion was flawless and occured in a second or two. Your experience may vary based on CPU, RAM and length of the document converted. The Markdown file of our lease review was converted to “ProposedLease.docx” which I could easily share with my colleagues who were using Microsoft Word.

If you are a person who is uncomfortable installing software on your computer or you are an unpriviledged user in a corporate or educational setting you can use Pandoc online. Pandooc is open source with a GPL v2 license. For more information about Pandoc be sure to consult their website and examine all of the options that the program provides you.

Mastering Markdown with MarkText

A few years back, I learned about Markdown. I had never heard of it until I started exploring Jupyter Notebooks. Markdown was a familiar skill to many of my writing colleagues. It remained an uncharted territory for me.

Markdown is a universal method for composing text, employing concise notation to apply to style. For instance, rather than relying on a button click to emphasize a word, you envelop the word with two asterisks **word**.

Markdown holds a significant edge in its reliance on intuitive notations, often drawing from our ingrained habits. Employing asterisks for emphasis, and utilizing characters to distinguish headlines – these practices align seamlessly with our natural inclinations.

While its merits were extolled by many, I remained uncertain about the necessity of acquiring markdown skills. My inherent curiosity, however, drove me to delve into the realm of markdown, investigating how it could integrate into my writing endeavors.

As I underwent the learning process, I found an excellent Markdown cheat sheet online and discovered that I could write Markdown in any simple text editor like ‘nano’, ‘vim’, or ‘gedit’. While it is technically possible to use almost any text editor to write Markdown, it is much more powerful to use an editor specifically designed to output Markdown formatted documents.

I stumbled upon MarkText, a platform equipped with features that streamline markdown writing while presenting an unobtrusive interface. This tool boasts six themes, comprising three light and three dark options. I find the dark themes more comfortable to work with. Notably, the user documentation is comprehensive, and a dedicated resource for markdown syntax assistance is also available.

MarkText presents a clean, minimalistic interface with a real-time preview feature. It accommodates several markdown specifications, including Commonmark, Github Flavored Markdown, and Pandoc Markdown. Its official website shows MarkText supports markdown enhancements like KaTex, front matter, and emoji usage. The application is capable of generating both HTML and PDF output files.

Within Mark Text, you’ll find diverse editing modes such as typewriter mode, source code mode, and focus mode. Incorporating images is effortlessly achieved by copying and pasting them directly from the clipboard.

For added convenience, a pop-up situated in the upper-left corner of the Mark Text interface provides a continuous tally of the characters and paragraphs that have been entered. This proves particularly advantageous for writers.

Saving files is a straightforward task accessible via the upper-left menu of the MarkText window or by employing the Ctrl+S shortcut. Remarkably, the menus within Mark Text bear a friendly and recognizable resemblance to those found in fundamental text editors or word processors, creating a sense of familiarity for users.

The versatility of Mark Text truly impresses me, as it effortlessly accommodates many formats through simple keystroke shortcuts. These include table blocks, diagrams, inline formats, math formula blocks, and other code blocks.

You can acquire Mark Text for your respective operating system through the following links:

Mark Text is an open-source project governed by the MIT license. The latest version can always be obtained via download.

Alternatively, on macOS, you can install Mark Text using

brew install --cask mark-text

On Windows, installation can be accomplished through Chocolatey by running

choco install marktext.

Mark Text continually seeks the support of sponsors and developers. The project provides a guide for those interested in contributing. Furthermore, you can back the project on Patreon and Open Collective.

This article is adapted from Why MarkText is my favorite markdown editor