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.
![](/var/linux_magazin/storage/images/issues/2017/201/tutorials-markdown/figure-4/708269-1-eng-US/Figure-41_large.png)
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.
![Learn More](https://www.linux-magazine.com/var/linux_magazin/storage/images/media/linux-magazine-eng-us/images/misc/learn-more/834592-1-eng-US/Learn-More_medium.png)
News
-
NVIDIA Released Driver for Upcoming NVIDIA 560 GPU for Linux
Not only has NVIDIA released the driver for its upcoming CPU series, it's the first release that defaults to using open-source GPU kernel modules.
-
OpenMandriva Lx 24.07 Released
If you’re into rolling release Linux distributions, OpenMandriva ROME has a new snapshot with a new kernel.
-
Kernel 6.10 Available for General Usage
Linus Torvalds has released the 6.10 kernel and it includes significant performance increases for Intel Core hybrid systems and more.
-
TUXEDO Computers Releases InfinityBook Pro 14 Gen9 Laptop
Sporting either AMD or Intel CPUs, the TUXEDO InfinityBook Pro 14 is an extremely compact, lightweight, sturdy powerhouse.
-
Google Extends Support for Linux Kernels Used for Android
Because the LTS Linux kernel releases are so important to Android, Google has decided to extend the support period beyond that offered by the kernel development team.
-
Linux Mint 22 Stable Delayed
If you're anxious about getting your hands on the stable release of Linux Mint 22, it looks as if you're going to have to wait a bit longer.
-
Nitrux 3.5.1 Available for Install
The latest version of the immutable, systemd-free distribution includes an updated kernel and NVIDIA driver.
-
Debian 12.6 Released with Plenty of Bug Fixes and Updates
The sixth update to Debian "Bookworm" is all about security mitigations and making adjustments for some "serious problems."
-
Canonical Offers 12-Year LTS for Open Source Docker Images
Canonical is expanding its LTS offering to reach beyond the DEB packages with a new distro-less Docker image.
-
Plasma Desktop 6.1 Released with Several Enhancements
If you're a fan of Plasma Desktop, you should be excited about this new point release.