ПРАВИЛА ОФОРМЛЕНИЯ ФАЙЛА README.MD НА GITHUB

Untitled-2

**ПРАВИЛА ОФОРМЛЕНИЯ ФАЙЛА README.MD НА GITHUB*
<GITHUB></GITHUB>
Если вы начали работу на GitHub, решили загрузить туда свой проект для совместной работы с единомышленниками, то, скорее всего, в первую очередь перед вами встанет проблема создания первого файла – файла «readme.md».

Можно, конечно, просто выложить простой, неформатированный текстовой файл. Но вам захочется сделать его удобочитаемым, чтобы ссылки были выделены, блоки кода, присутствовали таблицы и так далее…
Эта статья поможет вам в этом.

Для форматирования текста на GitHub используются достаточно простые правила. Я перечислю основные и достаточные, так как не претендую на полноту официального руководства.

Текст можно обработать в любом простом текстовом редакторе, например в Notepad++, которым пользуюсь сам. А можно и прямо на GitHub редактировать файл в он-лайн режиме.

Стилистическая разметка должна быть такой:

Разбиение на абзацы производится вставкой пустой строки между ними (нажмите "Enter" после абзаца).

Горизонтальная полоса между абзацами - тег <hr> - три или более звёздочек или дефисов

Первый абзац
***
Второй абзац
или

Первый абзац
---
Второй абзац
Далее - заголовки и прочее:

h1 заголовок первого уровня
=====================
h2 заголовок второго уровня
-----------------------------------
### h3 заголовок третьего уровня
#### h4 заголовок четвёртого уровня
##### h5 заголовок пятого уровня
###### h6 заголовок шестого уровня
Оформление ссылки [Видимая часть, название ссылки] (http://webdesign.ru.net адрес ссылки - невидимая часть)

[Мой сайт](http://webdesign.ru.net)
Если заключить адрес в угловые скобки, то он автоматически станет ссылкой

<http://webdesign.ru.net>
Выделение жирным шрифтом

**Жирный шрифт**
***Наклонный жирный***
Выделение тёмным фоном прямо в тексте

`выделенные слова`
Блок текста с более тёмным фоном, четыре пробела (и более) от начала каждой строки

    dir /fonts
    dir /images
    dir /js
Блоки текста с подвеченным синтаксисом. Выделенный цветом фона блок с html-кодом. Теги выделяются цветом по правилам html

```html
<meta name="viewport" content="width=device-width, initial-scale=1.0">
```
Выделенный цветом фона блок с php-кодом. Теги выделяются цветом по правилам php

```php
<?php here_pagecontent(); ?>
```
Выделенный цветом фона блок с каскадными таблицами. Теги выделяются цветом по правилам css

```scss /* или css */
@import "bower_components/tree-normalize/generic.normalize";
h1 {
 font-size:1.5em;
 font-weight: 300;
}
```
И так далее...

Блок текста, выделенный тёмной полосой по левому краю (цитата)

> Текст
> 
> Продолжение текста выделенного блока
> Завершение текста
Допустимы вложенные цитаты (цитата в цитате). Тогда цитата второго уровня выделяется двумя знаками ">>", а цитата третьего уровня вложенности - тремя.

Таблица с чередованием светлых и тёмных строк (зебра)

Название файла  | Содержание файла
----------------|----------------------
style.css       | Пустой файл каскадной таблицы стилей, в который производится сбока необходимых стилей
reset.css       | Reset CSS от Эрика Мейера
normalize.css   | Нормалайзер CSS от Nicolas Gallagher
block.css       | Основные стили блоков системы
addition.css    | Дополнительные стили
fontawesome.css | Стили иконочного шрифта
layout.css      | Основные стили, применительно к определённому сайту
lightbox.css    | Стили лайтбокса, если таковой используется
index.html      | Индексный файл для проверки вносимых изменений
<li> Листинг - ненумерованый список

* Пункт 1
* Пункт 2
* Пункт 3
Нумерованный список создаётся ещё проще:

1. Пункт 1
2. Пункт 2
3. Пункт 3
italic - наклонный шрифт. Пробел, знак препинания или подчёркивание отменяют правило маркера

_наклонный_ _шрифт_ _наклонный__шрифт_
Комбинируя эти маркеры вы сможете правильно разметить свой текст, сделать его более понятным.

Надеюсь, что эта статья будет вам полезна. Успехов в работе на GitHub!

UPDATE!

Вставка изображения в текст

![screenshot of sample](http://webdesign.ru.net/images/Heydon_min.jpg)
Восклицательный знак обозначает изображение, в квадратных скобках даётся краткое описание, в обычных круглых скобках - полная ссылка на изображение.

Super! Thenkyou!