blob: 02f721296240d44a8e7a216b9da070dc0969f154 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
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' `cmd`, 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 links over inline links.
Omit the second pair of brackets `[]` entirely where appropriate.
For example, [Google] is preferred over both [Google](https://ya.ru) and
[I'm feeeling lucky][google] (see document source).
* First- and second-level headers are underlined (with `=` and `-`).
The number of `=`/`-` 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.
* Don't mix fenced code blocks with indented code blocks in a single document.
In a table, | the | first row | is underlined.
----------- | --- | --------- | --------------
Leftmost | and | rightmost | vertical
lines | are | omitted. |
[Google]: https://www.google.com/
|
