Markdown: One Format to Rule Them All
Advanced Usage
So far, we've been converting our work to HTML, because that's the only output format supported by the main Markdown tool. But there's another app we can use to convert to a much wider range of formats called Pandoc [7]. This is an immensely versatile program – available in the package repositories of most Linux distros – and once you have it installed, you can see how many formats it supports by running:
pandoc --help
That shows quite a bit of output, but you can scroll up to see the input and output formats. For exchanging documents with word processor users, the two most useful formats are .docx
(Microsoft Word) and .odt
(OpenDocument text, as used by LibreOffice – the better choice in terms of fully open standards).
So, create a Markdown document containing various bits of formatting from the previous examples in the tutorial. Add some headers, emphasis, paragraphs, bulleted lists, and horizontal lines. Save as test.md
as usual, and then run this command:
pandoc test.md -t odt -o test.odt
This tells Pandoc to use the .odt
format and send the results to a file called test.odt
. Open that file in LibreOffice, and you should see all the formatting from your Markdown document, implemented neatly in the word processor (Figure 4). Helpfully, the conversion uses OpenDocument paragraph styles for easier modification of the text – it's not just built around hard-coded sizes and formatting.
You may find Markdown so comfortable and useful that you want to use it all the time. If you live inside Emacs or Vim, you may want to make it your default format for long text documents – in which case, you'll want to convert other formats to Markdown before editing. Pandoc can do this as well. To test that, create a new LibreOffice Writer document called test2.odt
and put some content inside it. Mix up the formatting a bit (paragraph styles, bullet points, emphasis, etc.) and save it. Then, at the command line, run:
pandoc test2.odt -t markdown -o test2.md
Now look at the contents of test2.md
, and you should see some familiar Markdown code. (Note that you may see some slight differences, such as dashes being used for bullet points instead of asterisks, but it should largely be the same.) Of course, LibreOffice Writer can create documents way too advanced for replication in Markdown, so you may lose some formatting and need to tidy things up, but generally it works well.
As mentioned previously, Markdown is being adopted by more and more sites for quick publishing jobs, so here you've learned some valuable skills. And, best of all, you can get more done without leaving your trusty text editor!
Infos
- Markdown: https://daringfireball.net/projects/markdown/
- Remarkable: https://remarkableapp.github.io
- Dillinger: http://dillinger.io
- StackEdit: https://stackedit.io
- Markdown Vim Mode: https://github.com/plasticboy/vim-markdown
- Markdown Emacs package: http://jblevins.org/projects/markdown-mode/
- Pandoc: http://pandoc.org
« Previous 1 2
Buy Linux Magazine
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Support Our Work
Linux Magazine content is made possible with support from readers like you. Please consider contributing when you’ve found an article to be beneficial.
News
-
Gnome 47.1 Released with a Few Fixes
The latest release of the Gnome desktop is all about fixing a few nagging issues and not about bringing new features into the mix.
-
System76 Unveils an Ampere-Powered Thelio Desktop
If you're looking for a new desktop system for developing autonomous driving and software-defined vehicle solutions. System76 has you covered.
-
VirtualBox 7.1.4 Includes Initial Support for Linux kernel 6.12
The latest version of VirtualBox has arrived and it not only adds initial support for kernel 6.12 but another feature that will make using the virtual machine tool much easier.
-
New Slimbook EVO with Raw AMD Ryzen Power
If you're looking for serious power in a 14" ultrabook that is powered by Linux, Slimbook has just the thing for you.
-
The Gnome Foundation Struggling to Stay Afloat
The foundation behind the Gnome desktop environment is having to go through some serious belt-tightening due to continued financial problems.
-
Thousands of Linux Servers Infected with Stealth Malware Since 2021
Perfctl is capable of remaining undetected, which makes it dangerous and hard to mitigate.
-
Halcyon Creates Anti-Ransomware Protection for Linux
As more Linux systems are targeted by ransomware, Halcyon is stepping up its protection.
-
Valve and Arch Linux Announce Collaboration
Valve and Arch have come together for two projects that will have a serious impact on the Linux distribution.
-
Hacker Successfully Runs Linux on a CPU from the Early ‘70s
From the office of "Look what I can do," Dmitry Grinberg was able to get Linux running on a processor that was created in 1971.
-
OSI and LPI Form Strategic Alliance
With a goal of strengthening Linux and open source communities, this new alliance aims to nurture the growth of more highly skilled professionals.