Посетите сайт.
Получите его для Chrome.
Получите его для Firefox.
Получите его для Safari.
Получите это для Thunderbird.
Бери для Оперы.
Обсуждайте это и задавайте вопросы в обсуждениях GitHub.
Markdown Это расширение для Google Chrome, Firefox, Safari, Opera и Thunderbird, которое позволяет писать электронные письма † в Markdown ‡ и отображать их перед отправкой. Он также поддерживает подсветку синтаксиса (просто укажите язык в изолированном блоке кода).
Написание электронного письма с кодом довольно утомительно. Писать Markdown с кодом легко. Я обнаружил, что пишу электронное письмо в Markdown во встроенном редакторе GitHub, а затем копирую предварительный просмотр в электронное письмо. Это довольно абсурдный рабочий процесс, поэтому я решил создать инструмент для написания и рендеринга Markdown прямо в электронном письме.
Чтобы узнать, что можно сделать с помощью Markdown в Markdown Here , ознакомьтесь со шпаргалкой Markdown Here и другими вики-страницами.
†: И публикации в группах Google, и публикации в Blogger, и заметки Evernote, и публикации в Wordpress! Смотрите больше.
‡: И математические формулы TeX!
Инструкции по установке
Инструкции по использованию
Поиск неисправностей
Совместимость
Заметки и разное
Сборка пакетов расширений
Следующие шаги, авторы, отзывы, лицензия
Перейдите на страницу Интернет-магазина Chrome для Markdown Here и установите его в обычном режиме.
После установки обязательно перезагрузите веб-почту или перезапустите Chrome!
src
.Перейдите на страницу дополнений Firefox для Markdown Here и установите его в обычном режиме.
Или перейдите в меню «Инструменты > Дополнения» и найдите «Markdown Here».
После установки обязательно перезапустите Firefox/Thunderbird!
Примечание. Mozilla одобрение изменений в расширении Firefox/Thunderbird занимает до месяца, поэтому обновления (функции, исправления) будут отставать от показанных здесь. Вы можете вручную выбрать установку самой новой версии до ее проверки из списка версий: https://addons.mozilla.org/en-US/firefox/addon/markdown-here/versions/.
Загрузите расширение напрямую. Когда загрузка завершится, дважды щелкните по нему, чтобы установить.
Чтобы перейти к настройкам Markdown Here, откройте настройки Safari и перейдите на вкладку «Расширения». Затем щелкните поле «Нажмите меня, чтобы показать здесь параметры Markdown».
Обратите внимание, что Markdown Here работает только с версиями Opera 16 и выше (т. е. теми, которые основаны на Chromium).
Перейдите на страницу магазина дополнений Opera для Markdown Here и установите его в обычном режиме.
После установки обязательно перезагрузите веб-почту или перезапустите Chrome!
Установите его, а затем…
В Chrome/Safari/Opera обязательно перезагрузите страницу веб-почты, прежде чем пытаться использовать Markdown Here.
В Chrome/Firefox/Safari/Opera войдите в свою учетную запись Gmail, Hotmail или Yahoo и создайте новое электронное письмо. В Thunderbird создайте новое сообщение.
Убедитесь, что вы используете расширенный редактор.
Напишите электронное письмо в Markdown. Например:
**Привет**, `мир`. ```Javascript alert('Привет, подсветка синтаксиса.'); ```
Щелкните правой кнопкой мыши поле создания сообщения и выберите пункт «Переключить уценку» в контекстном меню. Или нажмите кнопку, которая появляется в адресной строке. Или используйте горячую клавишу (по умолчанию CTRL + ALT + M ).
Вы должны увидеть, что ваше электронное письмо правильно отображается из Markdown в форматированный HTML.
Отправьте свое потрясающее электронное письмо всем, кого вы знаете. Им это покажется так же, как и вам.
После преобразования вашего Markdown в красивый HTML вы все равно можете вернуться к исходному Markdown. Просто щелкните правой кнопкой мыши в любом месте недавно созданного Markdown и нажмите «Переключить Markdown» — тело создания электронного письма снова изменится на написанное вами Markdown.
Обратите внимание, что любые изменения, внесенные вами в красивый HTML-код, будут потеряны при возврате к Markdown.
В Gmail вы также можете использовать команду «Отменить» браузера ( CTRL + Z / CMD + Z или из меню «Правка»). Имейте в виду, что вы также можете потерять несколько последних введенных символов.
В Gmail, Thunderbird и группах Google вы можете использовать «Переключение Markdown» обычным способом: просто напишите свой ответ (сверху, снизу, внутри строки и т. д.), а затем преобразуйте. Исходное письмо, на которое вы отвечаете, останется в покое. (Технически: существующие блоки blockquote
останутся нетронутыми.)
В Hotmail и Yahoo (которые не помещают оригинал в blockquote
) и (необязательно) в Gmail, Thunderbird и группах Google вы можете гарантировать, что будет преобразована только часть написанного вами ответа, выбрав то, что вы хотите преобразовать. а затем нажмите «Переключить Markdown» — см. следующий раздел.
Иногда вам не нужно конвертировать всю электронную почту; иногда ваша электронная почта не полностью Markdown. Чтобы преобразовать только часть электронного письма, выделите текст (мышью или клавиатурой), щелкните его правой кнопкой мыши и выберите пункт меню «Переключить разметку». Ваш выбор волшебным образом преобразуется в красивый HTML.
Чтобы вернуться к Markdown, просто поместите курсор в любое место блока преобразованного текста, щелкните правой кнопкой мыши и снова выберите пункт меню «Переключение Markdown». Теперь он волшебным образом вернулся к исходному Markdown.
Если вы выберете только часть блока текста, будет преобразован только этот текст. Преобразованный блок будет заключен в элемент абзаца, поэтому исходная строка будет разбита. Вероятно, вы никогда не захотите этого делать.
Вы можете выбрать и отменить несколько преобразованных блоков одновременно. Одним из результатов этого является то, что вы можете выбрать все свое электронное письмо, нажать «Переключить уценку», и все его части, которые вы конвертировали, будут восстановлены.
Если при нажатии «Переключить Markdown» у вас ничего не выбрано, Markdown Here проверит, есть ли где-нибудь в сообщении преобразованные блоки, и вернет их. Если преобразованных блоков не обнаружено, будет преобразовано все электронное письмо.
Доступ к странице параметров Markdown Here можно получить через список расширений Chrome, Firefox, Safari или Thunderbird. Доступные варианты включают в себя:
Для Chrome и Firefox любые изменения, внесенные в параметры Markdown Here, автоматически синхронизируются между другими вашими установками этого браузера (если в браузере включена функция синхронизации).
См. вики-страницу «Устранение неполадок».
См. вики-страницу совместимости.
Markdown Здесь используется Markdown со вкусом Github, с тем ограничением, что специальные ссылки GFM не поддерживаются (проблема № 11); и не будет, поскольку MDH не специфичен для Github.
Доступные языки для подсветки синтаксиса (и способ их написания в изолированном блоке кода) можно увидеть на демонстрационной странице Highlight.js.
Изображения, встроенные в ваш Markdown, будут сохранены, когда вы «переключите Markdown». Gmail позволяет вам вставлять изображения в ваше электронное письмо — это может быть намного проще, чем ссылаться на внешнее изображение.
Подписи электронной почты автоматически исключаются из преобразования. В частности, все, что стоит после полустандартного '-- '
(обратите внимание на конечный пробел), остается в покое.
'-- '
в подписи, поэтому вам придется добавить его самостоятельно.Пункт меню «Переключение уценки» отображается для большего количества типов элементов, чем он может правильно отобразить. Это сделано для того, чтобы помочь людям понять, что они не используют полнофункциональный редактор. В противном случае они просто не видят пункт меню и не знают почему.
Стиль:
a:hover
), не работает, поскольку они не совпадают на момент явного определения стилей. (В электронной почте стили должны быть явно применены ко всем элементам — таблицы стилей удаляются.)Чтобы узнать больше о дополнительных функциях, посетите раздел «Советы и рекомендации».
cd utils
node build.js
Создайте файл с расширением .zip
, содержащий следующие файлы и каталоги:
manifest.json
common/
chrome/
_locales
Создайте файл с расширением .xpi
, содержащий следующие файлы и каталоги:
chrome.manifest
install.rdf
common/
firefox/
Код, специфичный для браузера, находится в проекте markdown-here-safari
.
Используйте конструктор расширений Safari.
См. список проблем и вики-сайт Notes. Все идеи, ошибки, планы, жалобы и мечты окажутся в одном из этих двух мест.
Не стесняйтесь создавать проблему с запросом функции, если того, что вы хотите, еще нет. Если вы предпочитаете менее формальный подход к выдвижению идеи, опубликуйте ее в наших обсуждениях на GitHub.
Также требуется немало усилий, чтобы быть в курсе последних изменений во всех приложениях и веб-сайтах, на которых работает Markdown Here.
Markdown Здесь был написан на плечах гигантов.
Все ошибки, запросы функций, запросы на включение, отзывы и т. д. приветствуются. Создайте проблему. Или опубликуйте сообщение в обсуждениях GitHub.
Лицензия MIT: https://adampritchard.mit-license.org/ или см. файл LICENSE
.
Авторские права принадлежат Остину Андерсону, 2015 г. Лицензия на Markdown здесь в соответствии с лицензионным соглашением для участников MDH.
Лицензия Creative Commons Attribution 3.0, непортированная (CC BY 3.0)