Перегляд файлів розмітки офлайн [закрито]


609

Чи є спосіб відобразити .mdфайли в режимі офлайн, щоб ми знали, як вони будуть виглядати після завантаження в Github? Я маю на увазі показ README.mdфайлу як він вийшов у Github, а не як для редагування.

Потрібно працювати на Mac і Windows, оскільки я використовую обидва.

Відповіді:


428

Є кілька плагінів Chrome, які добре працюють. Я використовую Markdown Preview Plus .

Після встановлення увімкніть "Дозволити доступ до URL-адрес файлів" у розширеннях (меню> Додаткові інструменти> Розширення або chrome://extensions/замість цього введіть URL-адресу ).

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

Потім перетягніть файл Markdown на Chrome і скористайтеся улюбленим редактором для редагування.


3
дякую, розширення для Chrome завжди буде корисним; не потрібно використовувати додаткове програмне забезпечення
Avi,

37
Дякую! Встановлено і не вдалося зрозуміти, чому файли md не відображаються правильно - ключовим було "Дозволити доступ ...".
mattezell

1
Попередній перегляд Markdown не підтримує кодові блоки
ACyclic

2
Якщо бути більш конкретним, коли Markdown Preview стикається з `` `, він розміщує всі рядки в блоці коду в одному рядку. Тому я спробував Markview, згаданий swcool. Стиль не повністю відповідає github, але він принаймні розміщує кожен рядок у блоці коду на окремих рядках.
EL Rayle

2
Переключено з попереднього перегляду Markdown на Markdown Preview Plus, оскільки він фіксує кодові блоки та багато іншого. Відредагував мою відповідь вище, щоб відобразити це.
Джим Бергман

256

Я писав Grip деякий час тому, щоб зробити саме це. Він відображається точно так, як це робиться на GitHub, і надає кілька додаткових опцій:

  • Окрім README, Grip може надавати коментарі та проблеми GitHub
  • Клацніть по локальних посиланнях, щоб відобразити інші .md файли
  • API для використання у власних проектах
  • Експорт у файл HTML

Встановити за допомогою pip:

pip install grip

Потім перейдіть до каталогу, який містить ваш файл README, і запустіть:

grip

Пройдіть -hдля додаткової допомоги та варіантів.

Ось скріншот Grip-рендерінга Grip's README:

Скріншот гриф-рендерінга Grip

Сподіваюсь, це допомагає. Перевірте це тут .


2
@luchosrock Чи можете ви опублікувати суть Markdown, яка не відображається правильно? Якщо є якась невідповідність, то я подам помилку та виправлюю її.
Джо

2
@luchosrock Я думаю, що ви можете заплутати це все, однак. З власних документів gfms "поточна реалізація GFMS не забарвлює блоки вихідного коду", тоді як Grip - це. Grip використовує власний Markdown API GitHub і стилі нестандартно, а не індивідуальне рішення, саме це робить Grip таким точним. Також gfms заснований на вузлі , а не на Python.
Джо

2
На відміну від інших рішень, працює як шарм на Linux! Дякую!
ахмед

5
Легкий і милий. Дякую!
Бенджамін R

2
@Joe Щойно я це відкрив для себе. Чудова робота. Працює прекрасно.
idjaw

106

Атом Ґітуба. Отримує попередній попередній перегляд.

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

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


2
Це добре, якщо ви редагуєте багато файлів .md. І миттєвий попередній перегляд, без переключення на інший додаток, завжди є плюсом.
dval

Існує навіть пакет автоматичної прокрутки: github.com/mark-hahn/markdown-scroll-sync . Наразі вам доведеться виправити github.com/mark-hahn/markdown-scroll-sync/pull/66/files, щоб він працював із попередженнями.
Dror

1
Це теж гарна пропозиція. Миттєвий попередній попередній перегляд за допомогою "бічної панелі" - це бонус! Не потрібно постійно зберігати та вкладати вкладки.
AnimNations

Посилання внизу вашої відповіді не існує
xxx ---

64

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

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


2
Дивовижно і найпростіше!
Mayur Patil

2
Відмінна пропозиція. MS Visual Code - це дивовижний інструмент для безлічі різних речей у багатьох різних контекстах. Це безкоштовно; він працює на Windows, Linux та MacOS.
paulsm4

1
Класно, рішення я вже встановив! У мене з’ясувалося дві дрібниці: Щоб відкрити панель попереднього перегляду, клацніть правою кнопкою миші вкладку файла вгорі та виберіть «Відкрити попередній перегляд (Ctrl? Shift + V)». Щоб викликати інтелігенцію, про яку згадує @sundeep, натисніть Ctrl + Пробіл у вікні редактора.
arichards

3
ctrl + kv для попереднього перегляду
aderchox

62

Пізно на вечірку, але подивіться на MarkdownPad .


21
Якщо ви хочете отримати підтримку для ароматної надбавки з github, вам доведеться отримати MarkdownPad Pro - для ~ 15USD. Я особисто платив би, можливо, 5 доларів за це, але точно не 15 доларів. Тож якщо хтось може порекомендувати щось інше, будь ласка, зробіть це.
бурзум

4
Щойно заплатив 15 доларів за про-версію, що їм варто, але було б добре, якби він працював під Mono, щоб я міг використовувати його в linux / osx, куди в цей час прямує більше мого розробника.
Tracker1

MarkdownPad ненадовго повернувся в клубочки , тому я (попередження про розкриття інформації: так, я це зробив і продав) зробив MarkUpDown , який не надто пошарпаний на рівні 15 доларів. Має бути GitHub Markdown доброзичливим, і якщо це не так, дайте мені знати, як це не зробити, і я виправлю це.
ruffin

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

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/ (відкрити в будь-якому браузері)

На жаль, gfmsне відображається рядок, який розбиває так, як це робить GFM - він не вставляє a, коли в абзаці є один розрив рядка, як це робить GFM. Але для "чистого" рендерингу Markdown це добре.
Ед Рудер

2
Існує оновлена ​​версія gfms ( github.com/pawel-wiejacha/gfms ), яка використовує кращий вихідний маркер GFM (Позначений) і правильно вставляє розриви рядків. Він також має покращені списки каталогів та функцію експорту в PDF.
Pawel Wiejacha

5
Я спробував це, бо це звучало багатообіцяюче. Довелося встановити node.js (очікувано), але й python. Я здався, коли хотів отримати повний інструментарій для розробників C ++. Тож залежно від вашої платформи це може бути простим, але якщо ви працюєте в Windows, навіть не спробуйте цю пропозицію.
Чейз

Практично нічого, написане в NodeJS, не працює в Windows. Коли посібник "встановити це програмне забезпечення" починається з "npm install", я навчився важкому шляху просто піти. NodeJS не така кросплатформна, як розробники хотіли б, щоб люди вірили. Golang і Python аналогічно погані, але не такі погані, як Node. Єдиною мовою сценаріїв, про яку я знаю, це справді крос-платформа, яка працює скрізь з мінімальними зусиллями і не потребує встановлення сотень МБ мотлоху - PHP. PHP CLI - це прихований дорогоцінний камінь - він краще як сценарій мови командного рядка, ніж будь-що інше там.
CubicleSoft

27

Я знайшов спосіб переглянути його в PHP. Зробивши ще кілька прослуховувань, я знайшов два рішення для перегляду .md файлів у режимі офлайн та онлайн:

Я рекомендую офлайн-версію, щоб ви могли займатися редагуванням, навіть коли займаєтесь своєю справою на троні. :)


1
Також є безліч настільних додатків для перегляду .mdфайлів.
Метт Бал

Я цього не знав. Хто вони?
чарувати

3
google.com/search?q=markdown%20editor з'являється markdownpad.com досить негайно
Метт Балл

@enchance, чому PHP? Версія javascript була б кращою.
Pacerier

23

Є люди, які не користуються Google Chrome. Існує додаток Firefox під назвою Markdown Viewer, який може читати файли Markdown в автономному режимі.


1
Приємно, і ось нове посилання для WebExtensions (ff 57+).
Сам

Я щось пропускаю? Там написано "Файл, який наразі: // URL-адреси не підтримуються!" - Чи не дискваліфікує це як рішення? Крім того, багато відгуків про одну зірку говорять, що Webext не працює.
Мітч

19

ви пробували ReText ? Це гарний редактор на робочому столі Markdown


стільки залежностей. але здається приємним!
dmeu

Деякі відомості про встановлення reText на Mac OS X можна знайти тут
lauhub

1
Для цього вам може знадобитися встановити деякі залежності вручну: sudo apt-get install python3-docutils python3-markdown
Костянтин Смолянін

У Ubuntu 15.04 все встановлюється автоматично, і залежності, і асоціація типу mime.
колан

1
@Moytaba Схоже, що його перемістили до github: github.com/retext-project/retext
NuclearPeon

17

pandoc - це приємний інструмент перетворення тексту в текст, який вирішує проблему офлайн-візуалізації вашої Markdown. Просто видайте:

pandoc -f markdown -t html README.md > README.html

Просто встановив це і використав його на пару файлів. Чудово працює!
Едвард

14

Мені здалося, що розширення MarkView Google Chrome є досить корисним, адже він працює як шарм:

MarkView - це розширення Chrome для редагування та перегляду файлу розмітки з видом контуру, підтримкою декількох стилів формату таблиці, підсвічуванням синтаксису блоку коду та відміткою Github Flavored Markdown.

Особливості:

  1. Редагування та перегляд файлу розмітки у стилі веб-сторінки.
  2. Автоматичне перезавантаження локального файлу при зміні файлу ( Після встановлення: виберіть параметр "Дозволити доступ до URL-адрес файлів" у chrome: // extensions / )
  3. Показуйте контури біля вмісту прокручуваним способом
  4. Майте кнопки для GoTop, ViewSource та GoBottom
  5. Підтримка стилів таблиці Github з ароматизованою відміткою та виділення коду.
  6. Виділіть область коду для мов програмування (наприклад, `` `ruby)
  7. Підтримка друку веб-сторінок із пристойними перспективами (Chrome-> Файл-> Друк ...)
  8. Чуйний: коли розмір вікна менше 940 пікселів, контурний розділ автоматично буде приховано; розмір більше 940 пікселів, відобразиться розділ контуру.
  9. MarkView буде переглядати всі файли розмітки, за винятком файлів на raw.github.com, оскільки цей піддомен відображає лише джерело.

До MarkView додано більше функцій:

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

    • Додайте CSS теми та виберіть
    • Додайте стиль коду та виберіть
    • Напишіть CSS, Збережіть та запустіть

@swcool Якщо ви вважаєте, що маєте кращу відповідь, створіть свою власну, а не редагуючи когось іншого.
Джейсон

Я вважаю, @swcool є автором вищезгаданого розширення Chrome, він лише оновлює його?
mariomaric

Так, я є автором цього розширення Chrome. Мені подобається оновлювати вище опис кожного разу, коли в розширення додавалися нові функції. Таким чином можна зберегти MarkView в одному місці відповідей на одне запитання. Так, лише оновлення. Але здавалося, що система Stackoverflow не схвалила моє оновлення, тому мені доведеться зупинитись. @Jason
swcool


11

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


1
Це якісний редактор, дякую за голову!
Lea Hayes

23
Не безкоштовно: тексти.io/покупка
ТН.

4
Також не доступні для Linux.
jameshfisher

4
Я знайшов це для того, щоб відтворити багато файлів md досить погано.
Zv_oDD

2
На mac він вимагає попередньо встановити якийсь зовнішній інструмент "fandoc", який я не знаю і не довіряю, тим більше, що він лежить десь у моїй ОС. Сама обгортка (Тексти) важить близько 4 Мб, що є занадто великим для рендерінга .md, навіть без цього зовнішнього інструменту ... ну, не настільки вражаючий додаток.
Motti Shneor

11

У Geany є плагін для розмітки, який виконує неабияку роботу, надаючи також попередній перегляд Markdown на бічній панелі. Він також працює на Linux, Mac OS X та Windows.

Для його використання встановіть geany, а потім встановіть пакет geany-plugin-markdown та виберіть його з диспетчера плагінів.


Я використовую geany для всіх, і це відповідь, яку я очікував :)
Rutrus

9

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


Акуратний. Я поки чинив опір node.js, але хотів перевірити це, і це було вагомою причиною. Стайлінг не ідеальний, можливо, глядач повинен вставити відсутні файл css github?
pduey

8

Також є StackEdit . Він працюватиме як в Інтернеті, так і в автономному режимі (він використовує локальну пам’ять вашого браузера).

Ви також можете з'єднати його з Dropbox або Google Drive, щоб побачити файли, розміщені у хмарі.


4
Сховище браузера дуже обмежене. Дуже дуже обмежений.
Pacerier

8

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


Дякую! На жаль, плагін вимагає вбудованого інтерпретатора рубіну та деяких дорогоцінних каменів. Занадто багато залежностей для мене ...
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. Доданий бонус: ви можете легко змінити тему.


5

Для MAC я використовую Marked , для Windows - Muto-Mark . Обидва підтримують таблицю стилів GH.


+1: Я використовую MutoMark для windows: 1. Це дуже легко (395 КБ) 2. Приємний глядач 3. Можливість пошуку (Ctr + F) 4. Виділяє всі результати пошуку
Іман Махмудінасаб

1
на жаль, схоже, не підтримується асоціація файлів
draeron

4

Для OS X Mou дуже приємний, і він поставляється з двома темами GitHub CSS.


Приємно, але баггі. Наприклад, ви видалите позначки заголовка ###, але частина WYSIWYG все ще відображає його як заголовок. І так далі, і я думаю, що за 2 хвилини використання я знайшов 3 або 4 помилки.
моджуба

4

Ознайомтеся з Haroopad . Це дійсно приємний редактор #markdown. Він безкоштовний і доступний для багатьох платформ. Я спробував це на Mac OSX.


Цей огляд багатьох редакторів 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-файлу.
Motti Shneor

4

Просте рішення для більшості ситуацій: скопіюйте / вставте розмітку в переглядач у "хмарі". Ось два варіанти:

  1. Dillinger.io
  2. Дінгус

Нічого не встановлювати! Перехресна платформа! Перехресний браузер! Завжди в наявності!

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


І, звичайно, ви ділитесь своїми документами перед випуском перед усім світом, перш ніж навіть зможете їх довести ...
Motti Shneor

3

Ви можете використовувати розширення під назвою Markdown Syntax Highlighting для Notepad ++. Він доступний на Github

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

Після встановлення з'явиться нова опція у спадному меню Мова Після встановлення з'явиться нова опція у спадному меню Мова


1
Захоплююче Чи можете ви додати посилання на Github?
Смандолі

3
Це не дає відповіді на запитання. Мета - показати кінцевий результат, а не джерело.
Дерик


2

RStudio може обробляти файли розмітки та конвертувати їх у html та pdf. Якщо у вас вже є, ви можете використовувати RStudio (це IDE для мови програмування R). Він безкоштовний і з відкритим кодом, працює в Windows, Mac і Linux.


1

Ви можете використовувати Scribefire Next.

Це Mozilla Firefox плагін браузера . Просто встановіть розширення та запустіть Firefox. Налаштуйте панель інструментів і помістіть на неї ярлик Scribefire. А оскільки це плагін браузера, ви можете використовувати його в Mac, Linux та Windows.

Коли ви хочете писати в режимі Markdown, просто натисніть Edit Codeу вікні Scribefire.

Тепер, щоб відповідати своєму призначенню, перейдіть у Edit Codeрежим і скопіюйте всі тексти та вставте їх у .mdфайл та завантажте.

Для цього немає функції попереднього перегляду, вам потрібно перемикати Edit Codeта Edit Visuallyпереглядати текст.

Я використовую його у вікні Linux Mint:

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

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

Оновлення:

Це 2014 рік, потрібно додати сюди якийсь чудовий інструмент для інших читачів та дослідників. Нещодавно використовувані Brackets + Розширення попереднього перегляду Markdown .


Я люблю брекети !!! Ніякого спаму, я справді роблю
a7omiton


1

Я часто хочу переносити додатки. Для цього я знайшов

http://cloose.github.io/CuteMarkEd/ (я лише спробував це коротко, і, здається, працює добре).

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


Насправді насправді баггі
Данвелман

Я використав 0.11.3, і це прекрасно працює для мене ...
Tareq
Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.