Введение

Добро пожаловать в ghostwriter! Эта краткая справка показывает примеры использования Markdown, облегчённого языка разметки, созданного Джоном Грубером (John Gruber). Для дополнительной информации, посетите сайт Джона Грубера на http://www.daringfireball.net. Официальный сайт ghostwriter доступен на http://www.github.com/wereturtle/ghostwriter.

ghostwriter имеет встроенный конвертер Sundown. Однако, он может также автоматически обнаружить конвертеры Pandoc, MultiMarkdown, Discount, или cmark. Для их использования, просто установите их, и убедитесь, что их пути установки добавлены в переменную окружения PATH. ghostwriter обнаружит конвертеры при запуске и предоставит соответствующие опции для предпросмотра HTML и экспорта.

Заголовки

# Заголовок первого уровня
## Заголовок второго уровня ##
###### Заголовок шестого уровня

Заголовок первого уровня
===============
какой-то текст

Заголовок второго уровня
---------------
ещё текст

Абзацы

Это абзац.
Это другая строка всё того же абзаца, с ручным переводом строки.

Это — новый абзац.

Форматирование строк

Слова можно делать курсивными и даже жирными двумя способами. Первый — окружить их звёздочками (*). Второй — окружить подчёркиваниями (_).

*Курсив* со звёздочками.
_Курсив_ с подчёркиваниями.

**Жирно** и со звёздочками.
__Жирно__ и с подчёркиваниями.

Смешивая то и другое, можно получить жирный курсив:

***Жирный курсив*** со звёздочками.
**_Жирный курвив_** с тем и другим.
Вот ещё один *__жирный курсив__*.
Ну и так далее.

Ссылки

Можно делать ссылки на сайты:

Жми [сюда](http://url.com "Заголовок") чтобы зайти на сайт.

Ещё можно делать ссылки-сноски:

[Эту][id] ссылку определят чуть ниже.

[id]: http://url.com "Заголовок"

Картинки

Картинки вставляют вот так:

![альтернативный текст](./image.jpg "Заголовок")

Их можно определять так же, как и ссылки-сноски:

![alternate text][id] for a reference defined below.

[id]: ./image.jpg "Title"

Списки

Можно сделать нумерованный список:

1. Пункт первый.
2. Пункт второй.
3. Пункт третий.

А можно — маркированный:

* Первый пункт.
+ Второй.
- Третий.

Ещё их можно смешивать:

1. Пункт первый
    * Подпункт первый
    * Подпункт второй
2. Пункт второй
    - Подпункт раз
    - Подпункт два
3. Пункт третий
    1. Подпункт три

Блоки кода

Отступ четырьмя и более пробелами (а также отступ символами табуляции) порождает блок кода:

Простой абзац, за которым следует блок кода.
    
    for (int i = 0; i < 10; i++) {
        System.out.println("i = " + i);
    }
    
Фрагмент выше станет отформатированным блоком кода

Некоторые конвертеры Markdown, такие как Pandoc, позволяют выделить блок кода обратными апострофами вместо отступов:

```
for (int i = 0; i < 10; i++) {
    System.out.println("i = " + i);
}
```

Этот блок будет также отображён как неформатированный блок кода.

Строчный код

Код в середине абзаца можно обозначить обратными апострофами, как вот этот `<html>` тег. Содержащий обратные апострофы код можно выделить используя дополнительные апострофы, вот так: `` `экранированные апострофы` ``.

Блочные цитаты

Блочные цитаты обозначаются так же, как и в электронных письмах:

> Это — блочная цитата.
>
>> А это вложенная блочная цитата.

Горизонтальная черта

Горизонтальная черта получается из трёх дефисов (-), подчёркиваний (_) или звёздочек (*):

---

***
___

Между ними даже могут быть пробелы:

- - -

Расширения Markdown

Некоторые конвертеры Markdown добавляют синтаксис для таблиц, сносок и прочего, расширяя первоначальную спецификацию Markdown. Вот пример сноски для Pandoc, MultiMarkdown и других конвертеров, поддерживающих это расширение:

Этот текст снабжён сноской.[^footnoteid]

[^footnoteid]:  А вот, собственно, и она.

Вот пример таблицы Pandoc:

Column One     Column Two
----------     ----------
Row Text 1     Row Text 2
Row Text 1     Row Text 2

Table:  Pandoc sample table.

А вот пример таблицы Sundown или MultiMarkdown:

Column One  |  Column Two
----------  |  ----------
Row Text 1  |  Row Text 2
Row Text 1  |  Row Text 2

Конвертеры Markdown могут поддерживать множество других синтаксисов таблиц. И существует ещё много других расширений. Для дополнительной информации, посетите следующие сайты:

Первоначальная спецификация Джона Грубера можно найти на http://daringfireball.net/projects/markdown/.

Горячие клавиши

У ghostwriter есть несколько горячих клавиш для редактирования Markdown:

Ctrl+B
Применяет жирное форматирование.
Ctrl+I
Применяет курсивное форматирование.
Ctrl+K
Применяет перечёркнуторе форматирование.
Ctrl+/
Нажатие клавиши Ctrl вместе с / либо вставит комментарий HTML на место курсора, либо пребразует выделенный текст в комментарий.
Tab
Когда текст в редакторе выделен, нажатие клавиши табуляции добавляет отступы к выбраным строкам текста.
Shift+Tab
Когда текст в редакторе выделен, нажатие Tab вместе с Shift уберёт один уровень отступа у выбранных строк текста.
Shift+Enter
Вставляет перевод строки в стиле Markdown.
Ctrl+Enter
Вставляет обычные перевод строки, но игнорируя текущий отступ. Иначе говоря, если нажать Ctrl+Enter в строке с отступом, новая строка добавится без него. Обратите внимание, Ctrl можно совместить с Shift, получив тем самым перевод строки в стиле Markdown с новой стркой без отступа.
Ctrl+.
Нажатие Ctrl вместе с . превращает выделеные строки в блочную цитату.
Ctrl+,
Нажатие Ctrl вместе с , отменяет цитирование, превращая все блочные цитаты в выделеных строках в обычный текст.
Ctrl+8

Нажатие Ctrl вместе с 8 превращает выделенные строки в маркированный список с * в качестве маркера. Например, пусть выбраны следующие строки:

Первый элемент списка.
Второй элемент списка.

Нажатие Ctrl+8 превратит эти строки в такой список:

* Первый элемент списка.
* Второй элемент списка.
Ctrl+Shift+-

Нажатие Ctrl вместе с Shift и - превращает выделенные строки в маркированный список с - в качестве маркера. Например, пусть выбраны следующие строки:

Первый элемент списка.
Второй элемент списка.

Нажатие Ctrl+Shift+- превратит эти строки в такой список:

- Первый элемент списка.
- Второй элемент списка.
Ctrl+Shift+=

Нажатие Ctrl вместе с Shift и - превращает выделенные строки в маркированный список с + в качестве маркера. Например, пусть выбраны следующие строки:

Первый элемент списка.
Второй элемент списка.

Нажатие Ctrl+Shift+= превратит эти строки в такой список:

+ Первый элемент списка.
+ Второй элемент списка.
Ctrl+1

Нажатие Ctrl вместе с 1 (число 1) превращает выделенные строки в нумерованный список с маркером .. Например, пусть выбраны следующие строки:

Первый элемент списка.
Второй элемент списка.

Нажатие Ctrl+1 превратит эти строки в такой список:

1. Первый элемент списка.
2. Второй элемент списка.
Ctrl+0

Нажатие Ctrl вместе с 1 (число 0) превращает выделенные строки в нумерованный список с маркером ). Например, пусть выбраны следующие строки:

Первый элемент списка.
Второй элемент списка.

Нажатие Ctrl+0 превратит эти строки в такой список:

1) Первый элемент списка.
2) Второй элемент списка.
Ctrl+T

Нажатие Ctrl+T превращает выбранные строки в список задач в стиле Github. Например, пусть выбраны следующие строки:

Важная задача!
Другая задача, не менее важная.

Нажатие Ctrl+T превратит эти строки в список задач:

- [ ] Важная задача!
- [ ] Другая задача, не менее важная.
Ctrl+D

Если текущая строка является пунктом списка задач, нажатие Ctrl+D поменяет состояние задачи, поставив крестик, если его нет, или убрав крестик, если он есть. Например:

- [ ] Невыполненная задача.
- [x] `Ctrl+D` пометило эту задачу как выполненую!
", ', (, [, {, *, _, `, <

Если выбран текст внутри строки, ввод любого из этих символов заключит выделеный текст между этим символом и соответствующим закрывающим символом. Например, если выбрать слово кот и затем ввести (, слово кот будет заключено в скобки и превратится в (кот). Вот таблица открывающих и закрывающих символов:

Открывающие Закрывающие
" "
' '
( )
[ ]
{ }
* *
_ _
` `
< >

Чтобы сиволы автоматически дополнялись при наборе, включите опцию «Автоматически дополнять символы» в параметрах редактора. Там же можно настроить и то, какие именно символы дополнять.

Перетаскивание изображений

Вместо того, чтобы выбирать открывать меню правки и выбирать там «Вставить изображение…», можно просто перетащить файл изображения в окно редактора. Приложение вставит изображение с путём, относительным к расположению текущего документа, или же, если докумен не сохранён, изображение с полным путём. Например:

![](../../относительный/путь/к/файлу.png)

или если документ не сохранён:

![](file:///полный/путь/к/файлу.png)

Все права защищены © 2014-2017 wereturtle