From 15de698d1a6abd1d9da4befee7d54632d11ff54a Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Sat, 8 Oct 2016 23:23:23 +0300 Subject: initial commit (compiled from a couple of Gists) --- markdown.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 markdown.md (limited to 'markdown.md') diff --git a/markdown.md b/markdown.md new file mode 100644 index 0000000..8e25227 --- /dev/null +++ b/markdown.md @@ -0,0 +1,34 @@ +Markdown style guide +==================== + +* `diff`- and HTML-friendliness is valued over human-readability. +* Every sentence starts on a new line ("semantic newlines"). +* Lines are at most 79 characters wide, not counting neither the carriage +return, nor the line feed characters. + * Not 80 characters, because when you display a 80-character line with a +line feed at the end in Windows's Command Prompt, an extra empty line is added. +* No hanging indents in lists. + * Nested lists are indented with 4 spaces. + * No hanging indents in those also. + * Longer items wrap at 79 characters and continue from the leftmost +character column. +Additional sentences start there also. +* Prefer reference-style linkes over inline links. +Use implicit reference link names where appropriate, omitting the second pair +of brackets `[]` entirely. +* First- and second- level headers are underlined (with `=` and `-`). +The number of `=` (or `-`) signs must be equal to the number of characters in +the header. +* File paths are enclosed in double quotes. +Environment variable names are enclosed in a pair of backticks (\`) unless it's +a part of a path. +Executable names are enclosed in a pair of backticks (\`) unless it's a part of +a path, a link or a header. +* Code blocks are indented with 4 spaces. + + Code blocks inside lists are indented with 4 * (list nesting level + 1) spaces. + +In a table, | the | first row | is underlined. +----------- | --- | --------- | -------------- +Leftmost | and | rightmost | vertical +lines | are | omitted. | -- cgit v1.2.3