Tag
Markdown
Markdown files (.md): the syntax, the flavours that differ between GitHub and everything else, how to open and edit them on any device, and how to turn them into PDF.
10 posts
Plain Text vs Rich Text Files: .txt, .rtf, .md and .docx Compared
Understand the difference between plain text (.txt), rich text (.rtf), Markdown (.md) and Word (.docx) files, what each can hold and when to use each.
10 Common Markdown Mistakes and How to Fix Them
The ten Markdown errors that cause broken lists, missing line breaks, vanished tables and mangled links, with a quick fix for each.
Markdown Links and Images: Inline, Reference and Relative
How to write links and images in Markdown: inline and reference styles, relative paths, titles, alt text and the mistakes that break them.
How to Write a README.md That Gets Read
A good README.md answers who the project is for, how to start and where to get help. Learn a structure that works, plus what to leave out.
How to Convert Markdown to PDF: Four Reliable Methods
Four ways to turn a Markdown file into a PDF: in the browser, with Pandoc, from a code editor, or by printing HTML. Learn the trade-offs of each method.
How to Write Tables in Markdown (With Alignment and Escaping)
Learn the pipe-and-dash syntax for Markdown tables, how to align columns, escape pipes, handle line breaks in cells, and fix tables that will not render.
How to Open and Edit .md Files on Android
Android has no built-in Markdown viewer, so .md files often fail to open. Here is how to open, read and edit Markdown files on an Android phone or tablet.
Markdown Flavors Explained: CommonMark, GFM and Why They Differ
Why does Markdown render differently between apps? Learn how CommonMark, GitHub Flavored Markdown and other variants differ, and how to write portable files.
Markdown Syntax Cheat Sheet: Every Element You Need
A practical Markdown cheat sheet covering headings, emphasis, lists, links, images, code, quotes, tables and task lists, with the pitfalls that trip people up.
What Is a Markdown (.md) File and How Do You Open One?
A Markdown file is plain text with light formatting symbols. Learn what .md files are, how they differ from Word files, and how to open and edit one anywhere.