Просмотр файлов уценки в автономном режиме [закрыто]

609

Есть ли способ отображать .mdфайлы в автономном режиме, чтобы мы знали, как они будут выглядеть после загрузки в Github? Я имею в виду показ README.mdфайла таким, каким он будет в Github, а не для целей редактирования.

Нужно работать на Mac и Windows, так как я использую оба.

enchance
источник

Ответы:

428

Есть несколько плагинов Chrome, которые работают хорошо. Я использую Markdown Preview Plus .

После установки включите «Разрешить доступ к URL-адресам файлов» в разделе «Расширения» (меню> Дополнительные инструменты> Расширения или введите URL-адрес chrome://extensions/).

введите описание изображения здесь

Затем перетащите файл Markdown в Chrome и используйте ваш любимый редактор для редактирования.

Джим Бергман
источник
3
спасибо, расширение Chrome всегда будет полезно; не нужно использовать дополнительное программное обеспечение
Avi
37
Спасибо! Установлен и не может выяснить, почему md-файлы некорректно отображались - ключ «Разрешить доступ ...» был ключевым.
Mattezell
1
Предварительный просмотр Markdown не поддерживает блоки кода
ACyclic
2
Более конкретно, когда Markdown Preview встречает `` `, он помещает все строки в блоке кода в одну строку. Поэтому я попробовал Markview, упомянутый swcool. Стиль не полностью соответствует github, но он по крайней мере помещает каждую строку в блоке кода на отдельные строки.
EL Rayle
2
Переключен с Markdown Preview на Markdown Preview Plus, потому что он исправляет блоки кода и многое другое. Отредактировал мой ответ выше, чтобы отразить это.
Джим Бергман
256

Я написал Grip некоторое время назад, чтобы сделать именно это. Он отображается точно так же, как на GitHub, и предоставляет несколько дополнительных опций:

  • В дополнение к README, Grip может предоставлять комментарии и проблемы GitHub
  • Нажмите на локальные ссылки, чтобы отобразить другие .md файлы
  • API для использования в ваших собственных проектах
  • Экспорт в файл HTML

Установить с помощью pip:

pip install grip

Затем перейдите в каталог, содержащий ваш файл README, и запустите:

grip

Пройдите -hза дополнительной помощью и опциями.

Вот скриншот рендеринга Grip README Grip:

Снимок экрана рендеринга Grip Grip

Надеюсь это поможет. Проверьте это здесь .

Джо
источник
2
@luchosrock Не могли бы вы опубликовать суть Markdown, который не отображается правильно? Если есть какое-либо несоответствие, я сообщу об ошибке и исправлю ее.
Джо
2
@luchosrock Я думаю, что вы, возможно, путаете их. Из собственных документов gfms «текущая реализация GFMS не окрашивает блоки исходного кода», в то время как Grip делает. Grip использует собственный GitHub Markdown API и готовые стили, а не специальное решение, что делает Grip настолько точным. Кроме того, gfms основан на узлах , а не на Python.
Джо
2
В отличие от других решений, работает на Linux как прелесть! Спасибо!
Ахмед
5
Легкий и красивый. Спасибо!
Бенджамин Р
2
@Joe только что обнаружил это для себя. Отличная работа. Работает красиво.
idjaw
106

Атом от Github. Дает вам бок о бок предварительного просмотра.

введите описание изображения здесь

https://stackoverflow.com/a/26956920/375022

Максим
источник
2
Это хорошо, если вы редактируете много файлов .md. И мгновенный предварительный просмотр, без необходимости переключения на другое приложение, всегда является плюсом.
Дваль
Есть даже пакет автоматической прокрутки: github.com/mark-hahn/markdown-scroll-sync . В настоящее время вам придется исправлять файлы github.com/mark-hahn/markdown-scroll-sync/pull/66/file без предупреждений.
Дрор
1
Это тоже хорошее предложение. Мгновенный предварительный просмотр с параллельной панелью - это бонус! Нет необходимости сохранять и вкладывать постоянно.
AnimNations
Ссылка внизу вашего ответа не существует
ххх ---
64

Visual Studio Code - новый редактор от Microsoft также предоставляет очень хорошую поддержку для редактирования уценки.
Вы можете скачать его здесь .
Редактор обеспечивает хорошую поддержку для переключения между кодом уценки и режимом предварительного просмотра .
Он также обеспечивает достаточно хорошую поддержку intellisense для всего синтаксиса уценки.
Редактор бесплатный для использования, а также кроссплатформенный (работает на Linux, Windows и Mac).
Для более подробной информации вы можете проверить на их сайте

введите описание изображения здесь

Sundeep
источник
2
Классно и просто!
Майур Патил
2
Отличное предложение. MS Visual Code - это УДИВИТЕЛЬНЫЙ инструмент для множества разных вещей в самых разных контекстах. Это бесплатно; он работает на Windows, Linux и MacOS.
paulsm4
1
Круто, решение, которое я уже установил! У меня было две небольшие вещи, которые нужно выяснить: чтобы открыть панель предварительного просмотра, щелкните правой кнопкой мыши вкладку файла вверху и выберите «Открыть предварительный просмотр (Ctrl? Shift + V)». Чтобы вызвать intellisense, о котором упоминает @sundeep, нажмите Ctrl + Пробел в окне редактора.
аричардс
3
Ctrl +
KV
62

Поздно на вечеринку, но посмотрите на MarkdownPad .

Дэвид Брабант
источник
21
Если вы хотите получить поддержку для уценки GitHB, вам нужно будет получить MarkdownPad Pro - за ~ 15 долларов США. Я лично заплатил бы, возможно, 5 долларов США за это, но точно не 15 долларов США. Так что, если кто-то может порекомендовать что-то еще, пожалуйста, сделайте это.
Burzum
4
Просто заплатил 15 долларов за профессиональную версию, хотя это того стоит, но было бы неплохо, если бы она работала под Mono, чтобы я мог использовать ее в linux / osx, куда сейчас направляется большая часть моего разработчика.
Tracker1
У MarkdownPad некоторое время назад, похоже , возникли проблемы с нафталином, поэтому я (оповещение о раскрытии: да, я сделал и продал это) сделал MarkUpDown , который не слишком потертый за 15 долларов. Должен быть дружественным GitHub Markdown, и если это не так, дайте мне знать, как это не так, и я исправлю это.
Ерф
37

Смотрите Python-Markdown-Editor

Он основан на:

  • Python-Markdown
  • Фрагменты (выделение синтаксиса блока кода)
  • CodeMirror (редактор кода JavaScript)
  • бутылка

Установить с помощью pip:

$ pip install markdown-editor 

Это показывает предварительный просмотр, когда вы печатаете, выделение кода, выделенные блоки кода, стиль github

это может использоваться командной строкой:

$ markdown_edit 

$ markdown_edit README.md

$ markdown_edit -f readme.html README.md

введите описание изображения здесь

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

Николас Корнетт
источник
Здравствуйте, это, кажется, отличное приложение, однако я не могу открыть два файла .md одновременно, так как большую часть времени я просто хочу, чтобы он был зрителем, а не редактором. Будете ли вы расширять его с помощью такого синтаксиса, как localhost: 8000 / <path / to / file.md >, чтобы он мог просматривать несколько файлов .md?
arcticfox
Вы можете редактировать несколько файлов с -p <port>опцией
Николас Корнетт
выдает ошибку Traceback для меня
aderchox
29

Я только что установил https://github.com/ypocat/gfms . Он отлично справляется с рендерингом github. Он обнаруживает изменения в вашей уценке, поэтому вы просто ставите браузер и редактор рядом друг с другом. Это Node.js, поэтому он должен нормально работать на любой платформе.

Если у вас установлен Node.js, установка проста:

  1. sudo npm install -g gfms
  2. gfms --port 9999 (в каталоге вашего проекта)
  3. http://localhost:9999/ (открыть в любом браузере)
pduey
источник
К сожалению, gfmsрендеринг строк не прерывается так, как это делает GFM - он не вставляет символ <br>, когда внутри абзаца есть один разрыв строки, как это делает GFM. Но для «чистого» рендеринга Markdown это нормально.
Эд Рудер
2
Существует обновленная версия gfms ( github.com/pawel-wiejacha/gfms ), которая использует улучшенный бэкэнд GFM Markdown (отмечен) и правильно вставляет разрывы строк. Он также имеет улучшенные списки каталогов и функцию экспорта в PDF.
Павел Wiejacha
5
Я попробовал это, потому что это звучало многообещающе. Пришлось установить node.js (ожидается), но и Python. Я сдался, когда захотел полный набор инструментов разработчика C ++. Поэтому в зависимости от вашей платформы это может быть легко, но если вы работаете в Windows, даже не пытайтесь сделать это предложение.
Погоня
Почти ничего не написано в NodeJS работает на Windows. Когда руководство «Установить это программное обеспечение» начинается с «Установка npm», я научился нелегко просто уйти. NodeJS не такой кроссплатформенный, как хотелось бы разработчикам. Golang и Python также плохи, но не так плохи, как Node. Единственный известный мне язык сценариев, который действительно кросс-платформенный и работает везде с минимальными усилиями и не требует установки сотен МБ мусора, - это PHP. PHP CLI - это скрытая жемчужина - он лучше в качестве языка сценариев командной строки, чем все остальное.
CubicleSoft
27

Я нашел способ просмотреть его в PHP. После некоторого отслеживания я нашел 2 решения для автономного и онлайн просмотра файлов .md:

Я рекомендую автономную версию, чтобы вы могли редактировать, даже когда вы занимаетесь бизнесом на троне. :)

enchance
источник
1
Существует множество настольных приложений для просмотра .mdфайлов.
Мэтт Болл
Я этого не знал. Кто они такие?
Enchance
3
google.com/search?q=markdown%20editor поворачивает вверх markdownpad.com довольно сразу
Matt Болл
@enchance, почему PHP? Версия Javascript будет лучше.
Пейсер
23

Есть люди, которые не используют Google Chrome. Существует дополнение Firefox под названием Markdown Viewer, которое может читать файлы Markdown в автономном режиме.

воздушно-Dex
источник
1
Хорошо , и вот новая ссылка для WebExtensions (ff 57+).
Сэм
Я что-то пропустил? Там написано: «В настоящее время file: // URL не поддерживаются!» - Разве такого рода это не дисквалифицирует как решение? Кроме того, многие обзоры одной звезды говорят, что Webext один не работает.
Митч
19

вы пробовали ReText ? Это хороший настольный редактор Markdown

Нуно Коста
источник
так много зависимостей. но, кажется, достаточно хорош!
dmeu
Некоторая информация о том, как установить reText в Mac OS X, может быть найдена здесь
lauhub
1
Для этого вам может потребоваться установить некоторые зависимости вручную: sudo apt-get install python3-documentstils python3-markdown
Константин Смолянин
В Ubuntu 15.04 все настраивается автоматически, как зависимости, так и ассоциация mime-типов.
Колан
1
@Moytaba Похоже, что его перенесли на github: github.com/retext-project/retext
NuclearPeon
17

pandoc - это хороший инструмент для преобразования текста в текст, который решает проблему автономной визуализации вашей разметки. Просто выпустите:

pandoc -f markdown -t html README.md > README.html
tonicebrian
источник
Просто установил это и использовал на нескольких файлах. Работает отлично!
Эдвард
14

Я нашел расширение MarkView Google Chrome довольно полезным, на самом деле оно работает как шарм:

MarkView - это расширение Chrome для редактирования и просмотра файла уценки с контурным представлением, поддержкой нескольких стилей формата таблицы, подсветкой синтаксиса блока кода и Github Flavored Markdown.

Особенности:

  1. Редактирование и просмотр файла уценки в стиле веб-страницы.
  2. Автоматическая перезагрузка локального файла при изменении файла ( после установки: выберите параметр «Разрешить доступ к URL-адресам файлов» в chrome: // extensions / )
  3. Показывать контур рядом с контентом в режиме прокрутки
  4. Есть кнопки для GoTop, ViewSource и GoBottom
  5. Поддержка Github Flavored Markdown таблиц стилей и выделения кода.
  6. Выделите область кода для языков программирования (например, `` `ruby)
  7. Поддержка печати веб-страниц с хорошим внешним видом (Chrome-> File-> Print ...)
  8. Отзывчивый: когда размер окна меньше 940px, контурный раздел будет автоматически скрыт; изменить размер больше, чем 940px, отобразится контурная секция.
  9. MarkView будет просматривать все файлы уценки, кроме тех, которые находятся на raw.github.com, потому что этот поддомен отображает только источник.

Дополнительные функции были добавлены в MarkView:

  1. WYSIWYG редактор уценки
  2. Выбор тем и стилей кода
  3. Поддержка сносок 1
  4. Мгновенная презентация слайдов
  5. Пользовательский стиль документа

    • Добавьте тему CSS и выберите
    • Добавить стиль кода и выберите
    • Написать CSS, сохранить и запустить
mariomaric
источник
@swcool Если вы считаете, что у вас есть лучший ответ, пожалуйста, создайте свой собственный, а не редактируйте кого-либо еще.
Джейсон
Я считаю, что @swcool является автором вышеупомянутого расширения Chrome, он только обновляет его?
Мариомарик
Да, я автор этого расширения Chrome. Мне нравится обновлять приведенное выше описание всякий раз, когда в расширение были добавлены новые функции. Таким образом, MarkView можно сохранить в одном месте ответа в одном вопросе. Да, только обновление. Но, похоже, система Stackoverflow не одобрила мое обновление, поэтому я должен остановиться. @Jason
swcool
13

Мне нравится вертикальный сплиттер в Downmarker , вы можете видеть изменения, как вы пишете!

Натан Данн
источник
11

Вы можете использовать тексты как средство просмотра md и редактор md, его легкий и аккуратный. введите описание изображения здесь

PHPst
источник
1
Это качественный редактор, спасибо за хэдсэп!
Леа Хейс,
23
Не бесплатно: text.io/purchase
TN.
4
Также недоступно для Linux.
jameshfisher
4
Я нашел это, чтобы сделать многие файлы MD довольно плохо.
Zv_oDD
2
На Mac это требует предварительной установки некоторого внешнего инструмента "fandoc", который я не знаю или которому не доверяю, особенно потому, что он находится где-то в моей ОС. Сама оболочка (тексты) весит около 4 МБ, что слишком много для рендера .md, даже без этого внешнего инструмента ... ну, не очень впечатляющее приложение.
Мотти Шнеор
11

У Geany есть плагин для уценки, который справляется со своей задачей, предоставляя вам также предварительный просмотр уценки на боковой панели. Он также работает на Linux, Mac OS X и Windows.

Чтобы использовать его, установите geany, затем установите пакет geany-plugin-markdown и выберите его в диспетчере плагинов.

Akronix
источник
Я использую Geany для всех, и это ответ, который я ожидал :)
Rutrus
9

Я только что написал автономный просмотрщик уценок с помощью наблюдателя файлов node.js и socket.io, чтобы вы указали свой браузер на localhost и запустили ./markdownviewer /path/to/README.mdего, и он направил его в браузер с помощью веб-сокетов.

Уильям Буддингтон
источник
Ухоженная. До сих пор я сопротивлялся node.js, но хотел проверить это, и это было хорошей причиной. Стиль не идеален, возможно, зритель вставит отсутствующий файл github css?
pduey
8

Также есть StackEdit . Он будет работать как онлайн, так и офлайн (он использует ваш браузер локальное хранилище).

Вы также можете подключить его к Dropbox или Google Drive, чтобы увидеть файлы, размещенные в облаке.

N Alex
источник
4
Хранение браузера очень ограничено. Очень очень ограниченный.
Пейсер
8

Если вы vim человек, вы можете попробовать плагин vim-preview . Просто установите его в свой ~/.vimкаталог с вашим методом выбора. Затем вы можете открыть файл Markdown с помощью vim и использовать команду, :Previewкоторая откроет новое окно в вашем браузере и отобразит конечный результат.

Петр Диакумис
источник
Спасибо! К сожалению, плагин требует встроенного интерпретатора ruby ​​и некоторых драгоценных камней. Слишком много зависимостей для меня ...
xverges
1
Да, извините за это - я установил его некоторое время назад, поэтому забыл упомянуть о драгоценных камнях рубина (для будущих читателей: ссылка на плагин, которую я включил выше, описывает, как справиться с этим, если вы любите подобные рубиновые материалы) ,
Питер Диакумис
1
Другой плагин vim, использующий javascript: github.com/suan/vim-instant-markdown
matiasg,
7

Рассмотрим Страпон .

Strapdown - это решение на основе Javascript, которое отображает контент уценки в браузере, что делает его идеальным для просмотра в автономном режиме. Из собственного описания:

Strapdown.js упрощает создание элегантных документов Markdown. Компиляция на стороне сервера не требуется.

Поэтому переименуйте файл .mdуценки в .htmlи окружите его:

<xmp theme="united" style="display:none;">
# Markdown content here
…
</xmp>
<script src="http://strapdownjs.com/v/0.2/strapdown.js"></script>

и открытие в любом браузере покажет визуализированный HTML. Дополнительный бонус: вы можете легко сменить тему.

ckhan
источник
5

Для MAC я использую Marked , для Windows - Muto-Mark . Оба поддерживают таблицу стилей GH.

pseudomuto
источник
+1: я использую MutoMark для окон: 1. Он очень легкий (395 КБ) 2. Хороший зритель 3. Возможности поиска (Ctr + F) 4. Подсветка всех результатов поиска
Иман Махмудинасаб
1
к сожалению, не поддерживает файловую ассоциацию
draeron
4

Для OS X Mou очень хорош, и он поставляется с двумя темами GitHub CSS.

TachyonVortex
источник
Хорошо, но глючит. Например, вы удалите метки заголовка ###, но часть WYSIWYG по-прежнему показывает его как заголовок. И так далее, я думаю, я нашел 3 или 4 ошибки за 2 минуты использования.
моджуба
4

Проверьте Haroopad . Это действительно хороший редактор #markdown. Это бесплатно и доступно для нескольких платформ. Я пробовал это на Mac OSX.

qmmr
источник
Этот обзор многих редакторов WYSIWYG пришел к выводу, что Haroopad был лучшим. Это также доступно для Windows и Mac. Я только что загрузил его для редактирования вики-проекта GitHub, и пока он выглядит довольно хорошо.
TonyG
4

Одним из самых простых ресурсов, который хорошо работает в MacOSX, является плагин Markdown Quick Look, который можно найти в InkMark . После установки этого на OS X 10.9+, вы просто выбираете файл уценки в Finder и нажимаете пробел. Я не уверен, что результаты коррелируют на 100% с Github, но они довольно хороши и делают крошечное ненавязчивое решение для просмотра в автономном режиме. Mashable также написал статью о 78 различных инструментах, если вам нужны другие варианты.

Makrdown-QuickLook-Preview

Томми С.
источник
1
ЛУЧШИЙ. Я могу посчитать, сколько раз я выбирал файл .md и нажимал пробел, просто чтобы проклясть немного - сотнями, может быть, тысячами. Затем я бы "и" открыл с Mou ", подождите, закройте сторону редактирования - потому что предварительный просмотр сделан для редактирования и является просто неудобством при чтении только файла .md.
Мотти Шнеор
4

Простое решение для большинства ситуаций: скопируйте / вставьте уценку в средство просмотра в «облаке». Вот два варианта:

  1. Dillinger.io
  2. Dingus

Нечего устанавливать! Кроссплатформенность! Кросс-браузер! Всегда доступен!

Недостатки: могут возникнуть проблемы с большими файлами, стандартные проблемы безопасности облачных приложений.

аап
источник
И, конечно же, вы делитесь своими предварительными документами со всем широким миром, прежде чем даже сможете их доказать ...
Мотти Шнеор
3

Вы можете использовать расширение под названием Markdown Syntax Highlighting для Notepad ++. Доступно на Github

введите описание изображения здесь

После установки появится новая опция в выпадающем меню Language. После установки появится новая опция в выпадающем меню Language.

Сарвар Нишонбоев
источник
1
Захватывающе. Можете ли вы добавить ссылку на Github?
Smandoli
3
Это не отвечает на вопрос. Цель - показать конечный результат, а не источник.
Дерик
2

RStudio может обрабатывать файлы уценки и конвертировать их в HTML и PDF. Если у вас уже есть, вы можете использовать RStudio (это IDE для языка программирования R). Это бесплатно и с открытым исходным кодом, и работает на Windows, Mac и Linux.

Genom
источник
1

Вы можете использовать Scribefire Next.

Это плагин для браузера Mozilla Firefox . Просто установите расширение и запустите Firefox. Настройте свою панель инструментов и поместите на нее ярлык Scribefire. А поскольку это плагин для браузера, вы можете использовать его в Mac, Linux и Windows.

Если вы хотите написать в режиме уценки, просто нажмите Edit Code уценки в окне Scribefire.

Теперь, чтобы удовлетворить ваши цели, перейдите в Edit Codeрежим и скопируйте все тексты и вставьте его в свой.md файл и загрузите.

Для этого нет функции предварительного просмотра, вы должны переключаться Edit CodeиEdit Visually просматривать текст.

Я использую это в своей коробке Linux Mint:

введите описание изображения здесь

введите описание изображения здесь

Обновить:

Это 2014 год, нужно добавить какой-то другой замечательный инструмент для других читателей и исследователей. Совсем недавно использовал расширение Brackets + Markdown Preview .

GaryP
источник
Я люблю брекеты !!! Никакого спама я искренне не делаю
a7omiton
1

Популярный плагин Web Essentials для Visual Studio предлагает просмотрщик и редактор Markdown. Он также поддерживает синтаксис языка Github для добавления фрагментов кода.

http://vswebessentials.com/features/markdown

Кайл Б.
источник
1

Я часто хочу портативные приложения. Для этого я нашел

http://cloose.github.io/CuteMarkEd/ (Я только что кратко попробовал, и, кажется, работает нормально).

http://markdownpad.com/faq.html#portable

sancho.s ReinstateMonicaCellio
источник
Кажется, довольно
глючит на
Я использовал 0.11.3, и он хорошо работает для меня ...
Тарек