Afficher les fichiers de démarque hors ligne [fermé]


609

Existe-t-il un moyen d'afficher les .mdfichiers hors ligne afin que nous sachions à quoi ils ressembleront une fois qu'ils seront téléchargés dans Github? Je parle de montrer le README.mdfichier tel qu'il apparaîtrait dans Github, et non pas à des fins d'édition.

Doit fonctionner sur Mac et Windows car j'utilise les deux.

Réponses:


428

Il existe quelques plug-ins Chrome qui fonctionnent bien. J'utilise Markdown Preview Plus .

Après l'installation, activez «Autoriser l'accès aux URL de fichier» dans Extensions (menu> Plus d'outils> Extensions ou entrez URL à la chrome://extensions/place).

entrez la description de l'image ici

Faites ensuite glisser-déposer un fichier Markdown sur Chrome et utilisez votre éditeur préféré pour le modifier.


3
merci, une extension Chrome serait toujours utile; pas besoin d'utiliser de logiciel supplémentaire
Avi

37
Merci! Installé et n'a pas pu comprendre pourquoi les fichiers md ne s'affichent pas correctement - la clé "Autoriser l'accès ..." était la clé.
mattezell

1
L'aperçu de Markdown ne prend pas en charge les blocs de code
ACyclic

2
Pour être plus précis, lorsque Markdown Preview rencontre `` '', il place toutes les lignes du bloc de code sur une seule ligne. J'ai donc essayé Markview mentionné par swcool. Le style ne correspond pas complètement à github, mais il place au moins chaque ligne du bloc de code sur des lignes distinctes.
EL Rayle

2
Passé de Markdown Preview à Markdown Preview Plus car il corrige les blocs de code et bien plus encore. Modifié ma réponse ci-dessus pour refléter cela.
Jim Bergman

256

J'ai écrit Grip il y a quelque temps pour faire exactement cela. Il s'affiche exactement comme sur GitHub et propose également plusieurs options supplémentaires:

  • En plus des fichiers README, Grip peut afficher les commentaires et les problèmes GitHub
  • Cliquez sur les liens locaux pour afficher d'autres fichiers .md
  • Une API à utiliser dans vos propres projets
  • Exporter vers un fichier HTML

Installer avec pip:

pip install grip

Ensuite, allez dans le répertoire qui contient votre fichier README et exécutez:

grip

Passez -hpour obtenir de l'aide et des options supplémentaires.

Voici une capture d'écran du fichier README de Grip:

Capture d'écran de Grip rendu Grip

J'espère que cela t'aides. Découvrez-le ici .


2
@luchosrock Pourriez-vous publier un résumé de Markdown qui ne s'affiche pas correctement? S'il y a un décalage, je vais déposer un bogue et le corriger.
Joe

2
@luchosrock Je pense cependant que vous pouvez confondre les deux. D'après les propres documents de gfms, "l'implémentation actuelle de GFMS ne colore pas les blocs de code source", contrairement à Grip. Grip utilise la propre API Markdown de GitHub et les styles prêts à l'emploi, pas une solution personnalisée, ce qui rend Grip si précis. De plus, gfms est basé sur un nœud , pas Python.
Joe

2
Contrairement à d'autres solutions, fonctionne comme un charme sur Linux! Merci!
akhmed

5
Léger et charmant. Merci!
Benjamin R

2
@Joe Je viens de découvrir cela par moi-même. Bon travail. Fonctionne magnifiquement.
idjaw

106

Atom par Github. Vous donne un aperçu côte à côte.

entrez la description de l'image ici

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


2
C'est bien si vous modifiez de nombreux fichiers .md. Et l'aperçu instantané, sans avoir à basculer vers une autre application est toujours un plus.
dval

Il existe même un package de défilement automatique: github.com/mark-hahn/markdown-scroll-sync . Actuellement, vous devez patcher github.com/mark-hahn/markdown-scroll-sync/pull/66/files pour que cela fonctionne sans avertissements.
Dror

1
C'est également une bonne suggestion. L'aperçu instantané avec le panneau côte à côte est un bonus! Pas besoin de sauvegarder et de tabuler constamment.
AnimNations

Le lien en bas de votre réponse n'existe pas
xxx ---

64

Visual Studio Code - le nouvel éditeur de Microsoft fournit également un très bon support pour l'édition de démarques.
Vous pouvez le télécharger ici .
L'éditeur fournit un bon support pour basculer entre le code de démarque et le mode d'aperçu .
Il fournit également un support d' intellisense raisonnablement bon pour toute la syntaxe de démarquage.
L'éditeur est gratuit et est également multiplateforme (fonctionne sous Linux, Windows et Mac).
Pour plus de détails, vous pouvez vérifier sur leur site Web

entrez la description de l'image ici


2
Génial et plus simple!
Mayur Patil

2
Excellente suggestion. MS Visual Code est un outil incroyable , pour beaucoup de choses différentes, dans beaucoup de contextes différents. C'est gratuit; il fonctionne sur Windows, Linux et MacOS.
paulsm4

1
Cool, une solution que j'avais déjà installée! J'avais deux petites choses à comprendre: Pour ouvrir le volet d'aperçu, cliquez avec le bouton droit sur l'onglet du fichier en haut et sélectionnez "Ouvrir l'aperçu (Ctrl? Maj + V)". Pour appeler l'intellisense mentionné par @sundeep, appuyez sur Ctrl + Espace dans la fenêtre de l'éditeur.
arichards

3
ctrl + kv pour prévisualiser
aderchox

62

Tard dans la soirée, mais jetez un œil à MarkdownPad .


21
Si vous souhaitez obtenir un support pour le démarquage aromatisé github, vous devrez obtenir MarkdownPad Pro - pour ~ 15 USD. Personnellement, je paierais peut-être 5 USD, mais certainement pas 15 USD. Donc, si quelqu'un peut recommander autre chose, faites-le.
burzum

4
Je viens de payer les 15 $ pour la version pro, à mon humble avis, mais ce serait bien si elle fonctionnait sous Mono afin que je puisse l'utiliser sous linux / osx, qui est l'endroit où la plupart de mes développeurs se dirigent ces jours-ci.
Tracker1

MarkdownPad semblait aller dans les naphtalines il y a quelque temps, donc j'ai (Alerte de divulgation: Oui, j'ai fabriqué et vendu cela) créé MarkUpDown , qui n'est pas trop minable à 15 $. Devrait être compatible avec GitHub Markdown, et si ce n'est pas le cas, faites-le-moi savoir et ce sera réparé.
ruffin

37

Voir Python-Markdown-Editor

C'est basé sur :

  • Python-Markdown
  • Pygments (mise en évidence de la syntaxe du bloc de code)
  • CodeMirror (éditeur de code javascript)
  • Bouteille

Installer avec pip:

$ pip install markdown-editor 

Il offre un aperçu au moment de la frappe, la mise en évidence du code, des blocs de code clôturés, un style github

il peut être utilisé en ligne de commande:

$ markdown_edit 

$ markdown_edit README.md

$ markdown_edit -f readme.html README.md

entrez la description de l'image ici

J'ai créé cela pour construire un outil d'envoi de revues de code, il est facilement extensible, en l'important en tant que module vous pouvez ajouter des actions personnalisées.


Bonjour, cela semble être une excellente application, mais je ne peux pas ouvrir deux fichiers .md en même temps, car la plupart du temps, je veux juste que ce soit un visualiseur plutôt qu'un éditeur. Allez-vous étendre cela avec une syntaxe telle que localhost: 8000 / <chemin / vers / fichier.md > pour lui permettre de visualiser plusieurs fichiers .md?
arcticfox

Vous pouvez éditer plusieurs fichiers avec -p <port>option
Nicolas Cornette

donne une erreur de trace pour moi
aderchox

29

Je viens d'installer https://github.com/ypocat/gfms . Il fait un très bon travail de rendu de démarque aromatisé au github. Il détecte les changements dans votre démarque, vous n'avez donc qu'à mettre votre navigateur et votre éditeur côte à côte. Il s'agit de Node.js, il devrait donc fonctionner correctement sur n'importe quelle plate-forme.

Si Node.js est installé, l'installation est simple:

  1. sudo npm install -g gfms
  2. gfms --port 9999 (dans votre répertoire de projet)
  3. http://localhost:9999/ (ouvert avec n'importe quel navigateur)

Malheureusement, gfmsne rend pas les sauts de ligne comme le fait GFM - il n'insère pas de <br> quand il y a un seul saut de ligne à l'intérieur d'un paragraphe, comme le fait GFM. Mais pour le rendu Markdown "pur", ça va.
Ed Ruder

2
Il existe une version mise à jour de gfms ( github.com/pawel-wiejacha/gfms ) qui utilise un meilleur backend GFM Markdown (marqué) et insère correctement les sauts de ligne. Il a également amélioré les listes de répertoires et la fonction d'exportation PDF.
Pawel Wiejacha

5
J'ai essayé car cela semblait prometteur. J'ai dû installer node.js (attendu) mais aussi python. J'ai abandonné quand il voulait une chaîne d'outils de développement C ++ complète. Donc, selon votre plate-forme, cela peut être facile, mais si vous êtes sous Windows, n'essayez même pas cette suggestion.
Chase

Presque rien écrit en NodeJS ne fonctionne sous Windows. Lorsqu'un guide "installer ce logiciel" commence par "installer npm", j'ai appris la manière difficile de simplement m'en aller. NodeJS n'est pas aussi multiplateforme que les développeurs voudraient le croire. Golang et Python sont également mauvais mais pas aussi mauvais que Node. Le seul langage de script que je connaisse qui soit vraiment multiplateforme et fonctionne partout avec un minimum d'effort et ne nécessite pas l'installation de centaines de Mo de fichiers indésirables est PHP. La CLI PHP est un joyau caché - c'est mieux en tant que langage de script en ligne de commande qu'autre chose.
CubicleSoft

27

J'ai trouvé un moyen de le voir en PHP. Après avoir fait un peu plus d'espionnage, j'ai trouvé 2 solutions pour la visualisation hors ligne et en ligne des fichiers .md:

Je recommande la version hors ligne afin que vous puissiez faire vos modifications même lorsque vous faites vos affaires sur le trône. :)


1
Il existe également de nombreuses applications de bureau pour afficher les .mdfichiers.
Matt Ball

Je ne le savais pas. Que sont-ils?
enchance


@enchance, Pourquoi PHP? Une version javascript serait mieux.
Pacerier

23

Il y a des gens qui n'utilisent pas Google Chrome. Il existe un module complémentaire Firefox appelé Markdown Viewer qui est capable de lire les fichiers Markdown hors ligne.


1
Bien , et voici un nouveau lien pour les extensions Web (ff 57+).
Sam

Suis-je en train de manquer quelque chose? Il dit "Actuellement, les URL file: // ne sont pas prises en charge!" - ce genre de disqualification n'est-il pas une solution? En outre, de nombreuses critiques d'une étoile indiquent que celle de Webext ne fonctionne pas.
Mitch

19

avez-vous essayé ReText ? C'est un bel éditeur Markdown de bureau


tant de dépendances. mais semble assez sympa!
dmeu

Quelques informations sur la façon d'installer reText sur Mac OS X peuvent être trouvées ici
lauhub

1
Vous devrez peut-être installer certaines dépendances manuellement pour cela: sudo apt-get install python3-docutils python3-markdown
Konstantin Smolyanin

Tout est configuré automatiquement dans Ubuntu 15.04, les dépendances et l'association de type mime.
colan

1
@Moytaba ressemble à son déplacement vers github: github.com/retext-project/retext
NuclearPeon

17

pandoc est un bel outil de conversion de texte en texte qui résout le problème de visualisation hors ligne de votre Markdown. Il suffit d'émettre:

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

Je viens de l'installer et de l'utiliser sur quelques fichiers. Fonctionne très bien!
Edward

14

J'ai trouvé l' extension MarkView Google Chrome assez utile, en fait, cela fonctionne comme un charme:

MarkView est une extension Chrome pour éditer et afficher le fichier de démarque avec une vue d'ensemble, prendre en charge plusieurs styles de format de tableau, mettre en évidence la syntaxe du bloc de code et Github Flavored Markdown.

Fonctionnalités:

  1. Modification et affichage du fichier de démarque dans le style d'une page Web.
  2. Recharger automatiquement le fichier local lorsque le fichier est modifié ( Post-installation: sélectionnez l'option "Autoriser l'accès aux URL de fichier" dans chrome: // extensions / )
  3. Afficher le contour à côté du contenu de manière déroulante
  4. Avoir des boutons pour GoTop, ViewSource et GoBottom
  5. Prise en charge des styles de tableau Markdown Flavored Github et mise en évidence du code.
  6. Mettez en surbrillance la zone de code pour les langages de programmation (par exemple, `` ruby)
  7. Prise en charge de l'impression de pages Web avec des perspectives décentes (Chrome-> Fichier-> Imprimer ...)
  8. Réactif: lorsque la taille de la fenêtre est inférieure à 940 px, la section de contour sera automatiquement masquée; redimensionner plus grand que 940px, la section de contour s'affichera.
  9. MarkView affichera tous les fichiers de démarque à l'exception de ceux sous raw.github.com car ce sous-domaine n'affiche que la source.

Plus de fonctionnalités ont été ajoutées à MarkView:

  1. Éditeur de démarque WYSIWYG
  2. Thèmes et sélection de style de code
  3. Soutenir Notes 1
  4. Présentation des diapositives instantanées
  5. Style personnalisé du document

    • Ajouter un thème CSS et sélectionner
    • Ajouter un style de code et sélectionner
    • Écrire CSS, enregistrer et exécuter

@swcool Si vous pensez que vous avez une meilleure réponse, veuillez créer la vôtre, plutôt que de modifier quelqu'un d'autre.
Jason

Je crois que @swcool est l'auteur de l'extension Chrome mentionnée ci-dessus, il ne fait que la mettre à jour?
mariomaric

Oui, je suis l'auteur de cette extension Chrome. J'aime mettre à jour la description ci-dessus chaque fois que l'extension a été ajoutée de nouvelles fonctionnalités. De cette façon, vous pouvez conserver MarkView dans un seul endroit de réponse dans une seule question. Oui, mise à jour uniquement. Mais il semblait que le système Stackoverflow n'ait pas approuvé ma mise à jour, donc je dois m'arrêter. @Jason
swcool


11

Vous pouvez utiliser des textes en tant que visionneuse md et éditeur md, son léger et soigné. entrez la description de l'image ici


1
Ceci est un éditeur de qualité, merci pour le headsup!
Lea Hayes

23
Pas gratuit: textes.io/achat
TN.

4
Également non disponible pour Linux.
jameshfisher

4
J'ai trouvé cela pour rendre de nombreux fichiers md assez mal.
Zv_oDD

2
Sur le mac, cela nécessite de pré-installer un outil externe "fandoc", que je ne connais pas ou en qui je n'ai pas confiance, surtout qu'il se trouve quelque part dans mon OS. L'encapsuleur lui-même (Textes) pèse environ 4 Mo, ce qui est beaucoup trop gros pour un rendu .md, même sans cet outil externe ... eh bien, l'application n'est pas si impressionnante.
Motti Shneor,

11

Geany a un plugin pour markdown qui fait un bon travail, vous donnant également un aperçu Markdown dans la barre latérale. Il fonctionne également sous Linux, Mac OS X et Windows.

Pour l'utiliser, installez geany, puis installez le package geany-plugin-markdown et sélectionnez-le dans le gestionnaire de plugins.


J'utilise geany pour tous et c'est la réponse que j'attendais :)
Rutrus

9

Je viens de coder une visionneuse de démarques hors ligne en utilisant le fichier node.js watcher et socket.io, vous pointez donc votre navigateur sur localhost et vous l'exécutez ./markdownviewer /path/to/README.mdet il le diffuse vers le navigateur à l'aide de websockets.


Soigné. J'ai résisté à node.js jusqu'à présent, mais je voulais le vérifier et c'était une bonne raison. Le style n'est pas parfait, peut-être qu'un fichier github css manquant devrait être inséré par le spectateur?
pduey

8

Il y a aussi StackEdit . Il fonctionnera à la fois en ligne et hors ligne (il utilise le stockage local de votre navigateur).

Vous pouvez également le connecter avec Dropbox ou Google Drive pour voir les fichiers hébergés sur le cloud.


4
Le stockage du navigateur est très limité. Très très limité.
Pacerier

8

Si vous êtes une personne vim, vous pouvez essayer le plugin de prévisualisation vim . Installez-le simplement dans votre ~/.vimrépertoire avec la méthode de votre choix. Ensuite, vous pouvez ouvrir un fichier Markdown avec vim et utiliser la commande :Previewqui ouvrira une nouvelle fenêtre dans votre navigateur et affichera le résultat final.


Merci! Malheureusement, le plugin nécessite un interpréteur ruby ​​intégré et quelques gemmes. Trop de dépendances pour moi ...
xverges

1
Ouais, désolé pour ça - je l'avais installé il y a quelque temps donc j'ai oublié de mentionner les gemmes rubis (pour les futurs lecteurs: le lien du plugin que j'ai inclus ci-dessus décrit comment y faire face si vous êtes dans ce genre de choses rubis) .
Peter Diakumis

1
Un autre plugin vim, celui-ci utilisant javascript: github.com/suan/vim-instant-markdown
matiasg

7

Pensez à Strapdown .

Strapdown est une solution basée sur Javascript qui rend le contenu de démarque dans le navigateur, ce qui le rend idéal pour une visualisation hors ligne. De leur propre description:

Strapdown.js facilite la création de documents Markdown élégants. Aucune compilation côté serveur requise.

Renommez donc votre .mdfichier de démarque .htmlet entourez-le de:

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

et l'ouverture dans n'importe quel navigateur affichera le HTML rendu. Bonus supplémentaire: vous pouvez facilement changer de thème.


5

Pour MAC j'utilise Marked , pour Windows j'utilise Muto-Mark . Les deux prennent en charge la feuille de style GH.


+1: J'utilise MutoMark pour Windows: 1. Il est très léger (395 Ko) 2. Belle visionneuse 3. Capacité de recherche (Ctr + F) 4. Souligne tous les résultats de la recherche
Iman Mahmoudinasab

1
ne semble malheureusement pas soutenir l'association de fichiers
draeron

4

Pour OS X, Mou est très sympa, et il est livré avec deux thèmes CSS GitHub.


Agréable mais buggy. Par exemple, vous supprimez les marques d'en-tête ###, mais la partie WYSIWYG l'affiche toujours comme en-tête. Et ainsi de suite, je pense avoir trouvé 3 ou 4 bugs en 2 minutes d'utilisation.
mojuba

4

Découvrez Haroopad . Ceci est un très bel éditeur #markdown. Il est gratuit et disponible pour plusieurs plateformes. Je l'ai essayé sur Mac OSX.


Cette revue de nombreux éditeurs WYSIWYG a conclu que Haroopad était le meilleur. Il est également disponible pour Windows et Mac. Je viens de le télécharger pour éditer un wiki de projet GitHub et jusqu'à présent, il semble assez bon.
TonyG

4

L'une des ressources les plus simples qui fonctionne bien sur MacOSX est le plugin Markdown Quick Look trouvé sur InkMark . Après avoir installé cela sur OS X 10.9+, vous sélectionnez simplement un fichier de démarque dans le Finder et appuyez sur la barre d'espace. Je ne suis pas certain que les résultats soient corrélés à 100% avec Github, mais ils sont assez bons et constituent une toute petite solution de visionneuse hors ligne discrète. Mashable a également écrit un article sur 78 outils différents si vous souhaitez d'autres options.

Makrdown-QuickLook-Preview


1
LE MEILLEUR DE TOUT LES TEMPS. Je peux compter le nombre de fois où j'ai sélectionné un fichier .md et frappé l'espace, juste pour donner une petite malédiction - en centaines, voire en milliers. Je voudrais alors "et" ouvrir avec Mou ", attendez, fermez le côté édition - parce que l'aperçu côte à côte est fait pour l'édition et n'est qu'une nuisance lors de la lecture d'un fichier .md.
Motti Shneor

4

Une solution simple pour la plupart des situations: copiez / collez la démarque dans une visionneuse dans le «cloud». Voici deux choix:

  1. Dillinger.io
  2. Dingus

Rien à installer! Plateforme croisée! Navigateur croisé! Toujours disponible!

Inconvénients: pourrait être compliqué pour les fichiers volumineux, les problèmes de sécurité des applications cloud standard.


Et, bien sûr, vous partagez vos documents de pré-version avec le monde entier, avant même de pouvoir les
vérifier

3

Vous pouvez utiliser l'extension appelée Markdown Syntax Highlighting for Notepad ++. Il est disponible sur Github

entrez la description de l'image ici

Après l'installation, une nouvelle option dans la liste déroulante Langue apparaîtra Après l'installation, une nouvelle option dans la liste déroulante Langue apparaîtra


1
Passionnant. Pouvez-vous ajouter un lien vers Github?
Smandoli

3
Cela ne répond pas à la question. Le but est que le résultat final s'affiche, pas la source.
Deryck


2

RStudio peut gérer les fichiers de démarques et les convertir en html et pdf. Si vous l'avez déjà, vous pouvez utiliser RStudio (c'est un langage de programmation IDE pour R). Il est gratuit et open source, et fonctionne sur Windows, Mac et Linux.


1

Vous pouvez utiliser Scribefire Next.

C'est un Mozilla Firefox plugin de navigateur . Installez simplement l'extension et lancez Firefox. Personnalisez votre barre d'outils et placez-y le raccourci Scribefire. Et comme il s'agit d'un plugin de navigateur, vous pouvez l'utiliser sur Mac, Linux et Windows.

Lorsque vous souhaitez écrire en mode Markdown, cliquez simplement Edit Codedans la fenêtre Scribefire.

Maintenant, pour répondre à votre objectif, passez en Edit Codemode et copiez tous les textes et collez-le dans votre .mdfichier et téléchargez.

Il n'y a pas de fonction d'aperçu en direct pour cela, vous devez basculer Edit Codeet Edit Visuallyprévisualiser votre texte.

Je l'utilise dans ma boîte Linux Mint:

entrez la description de l'image ici

entrez la description de l'image ici

Mise à jour:

C'est l'année 2014, il faut ajouter un autre outil génial ici pour d'autres lecteurs et chercheurs. Récemment utilisé Brackets + Markdown Preview Extension .


J'adore les supports !!! Pas de spam, je le fais vraiment
a7omiton


En utilisant notre site, vous reconnaissez avoir lu et compris notre politique liée aux cookies et notre politique de confidentialité.
Licensed under cc by-sa 3.0 with attribution required.