Markdown

Markdown

Getting started with writing and formatting on GitHub - GitHub Help - https://help.github.com/articles/markdown-basics/

Daring Fireball: Markdown - http://daringfireball.net/projects/markdown/

"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)."

---

Markdown - Wikipedia - http://en.wikipedia.org/wiki/Markdown

"Markdown is a lightweight markup language, originally created by John Gruber with substantial contributions from Aaron Swartz, allowing people “to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML)”. The language takes many cues from existing conventions for marking up plain text in email. In other words, Markdown is a text-to-HTML conversion tool (for web writers).

Markdown is also a Perl script written by Gruber, Markdown.pl, which converts marked-up text input to valid, well-formed XHTML or HTML and replaces left-pointing angle brackets ('<') and ampersands with their corresponding character entity references. It can be used as a standalone script, as a plugin for Blosxom or Movable Type, or as a text filter for BBEdit.

Markdown has since been re-implemented by others as a Perl module available on CPAN (Text::Markdown), and in a variety of other programming languages. It is distributed under a BSD-style license[3] and is included with, or available as a plugin for, several content-management systems.

Sites such as GitHub, reddit, Stack Overflow and SourceForge use Markdown to facilitate discussion between users."

Quick Reference

https://commonmark.org/help/

Basic Syntax

https://www.markdownguide.org/basic-syntax/

Tutorial

https://commonmark.org/help/tutorial/

Testing

https://spec.commonmark.org/dingus/

Syntax

Source: http://daringfireball.net/projects/markdown/basics

Emphasis

Some of these words *are emphasized*.
Some of these words _are emphasized also_.

Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores instead__.

Headers

A First Level Header
====================

A Second Level Header
---------------------


# This is an H1 #

## This is an H2 ##

### This is an H3 #########

Paragraph

Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.

The quick brown fox jumped over the lazy
dog's back.

Block Quote

> This is a blockquote.
> 
> This is the second paragraph in the blockquote.
>

Block Quote Header

> ## This is an H2 in a blockquote

Lists

The following all produce the same unordered list styles:

*   Candy.
*   Gum.
*   Water.
  *   Salt.

+   Candy.
+   Gum.
+   Water.
  +    Salt.

-   Candy.
-   Gum.
-   Water.
  -   Salt.

Ordered list:

1.  Red
2.  Green
3.  Blue
    1. Yellow
    2. Purple

Note: need 4 spaces for the number list indent.

Links

This is an [example link](http://example.com/).

This is an [example link](http://example.com/ "With a Title").

Reference style links:

I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].

[1]: http://google.com/ "Google" [2]: http://search.yahoo.com/ "Yahoo Search" [3]: http://search.msn.com/ "MSN Search"

Code Blocks

Code blocks are normally indented four spaces or one tab.

    this is a
    code block.

Images

![Tux, the Linux mascot](/assets/images/tux.png)

Horizontal Rule

To create a horizontal rule, use three or more asterisks (***), dashes (---), or underscores (___) on a line by themselves

GitHub Flavored Markdown

See GitHub/GitHub Flavored Markdown

Linux

View on Command Line

See mdless

Convert to HTML

sudo apt install markdown

markdown file.md > file.html

ref: [1]

convert to DOCX

Pandoc can convert into several different formats

sudo apt install pandoc

pandoc file.md -f markdown -t html -s -o file.html

pandoc file.md -f markdown -t docx -s -o file.docx

ref: [2]