web-dev-qa-db-fra.com

Visualiseur Markdown

J'ai trouvé un fichier formaté avec Markdown. Pourriez-vous suggérer quel lecteur que je pourrais utiliser pour afficher ce type de fichiers? Si tout va bien sans gui (si c'est possible)

Mise à jour Je cherchais en fait une visionneuse qui pourrait analyser le format de fichier de démarque qui ne nécessite aucune conversion. Mais quelque chose de proche devrait être correct.

command-lineslackwaremarkdown
168
Amree

Le site Web suivant fournit un outil qui traduira le démarque en HTML:

http://daringfireball.net/projects/markdown/

Une fois que vous avez converti le fichier en HTML, il existe un certain nombre d'outils de ligne de commande à utiliser pour afficher le fichier. En utilisant un fichier de test qui contient du texte formaté markdown, j'ai trouvé que ce qui suit fonctionnait bien.

$ wget http://daringfireball.net/projects/downloads/Markdown_1.0.1.Zip
$ unzip Markdown_1.0.1.Zip
$ cd Markdown_1.0.1/
$ ./Markdown.pl ~/testfile.markdown | html2text

html2text est l'un des nombreux outils que vous pouvez utiliser pour afficher du texte au format html à partir de la ligne de commande. Une autre option, si vous voulez une sortie légèrement plus agréable, serait d'utiliser lynx :

$ ./Markdown.pl ~/testfile.markdown | lynx -stdin

Si vous êtes un utilisateur emacs, quelqu'un a écrit un mode de démarque qui est disponible ici: http://jblevins.org/projects/markdown-mode/ . Cela fournit une mise en évidence de la syntaxe de Nice, comme on peut le voir sur la capture d'écran de ce site Web.

Tous ces outils devraient être disponibles pour slackware.

40
Steven D

Utiliser pandoc et lynx sans créer de fichiers temporaires:

pandoc file.md | lynx -stdin
112
circleofconfusion

Remarque : crédits à @ Joe's answer in Stack Overflow.

Vous pouvez utiliser Grip , ce qui rend le Markdown exactement comme le ferait GitHub (il utilise API de markdown GitHub ).

Installez-le avec pip:

pip install grip

Pour rendre un fichier example.md:

grip -b example.md

À quoi cela ressemble:

enter image description here

52
Peque

J'ai écrit un visualiseur de démarque de terminal léger en python, pour CLI ou en tant que lib:

Il prend en charge par exemple des tableaux, des avertissements et des tonnes de thèmes de couleurs.

Usage:
mdv [-t THEME] [-T C_THEME] [-x] [-l] [-L] [-c COLS] [-f FROM] [-m] [-M   DIR] [-H] [-A] [MDFILE]

Options:
MDFILE    : Path to markdown file
-t THEME  : Key within the color ansi_table.json. 'random' accepted.
-T C_THEME: Theme for code highlight. If not set: Use THEME.
-l        : Light background (not yet supported)
-L        : Display links
-x        : Do not try guess code lexer (guessing is a bit slow)
-f FROM   : Display FROM given substring of the file.
-m        : Monitor file for changes and redisplay FROM given substring
-M DIR    : Monitor directory for markdown file changes
-c COLS   : Fix columns to this (default: your terminal width)
-A        : Strip all ansi (no colors then)
-H        : Print html version

enter image description here

49
Red Pill

Est un programme GUI, mais je trouve utile pour cette tâche ReText , c'est un éditeur pour Markdown et reStructuredText avec un mode de prévisualisation:

ReText screenshot

Cependant, si vous avez besoin de voir le fichier de ReText depuis un terminal, une option pourrait être de convertir le marddown en html avec pandoc et de voir la copie html dans lynx:

pandoc file.mkd > file.html ; lynx file.html

Modifier

Il existe quelques autres éditeurs de démarques gratuits avec aperçu disponibles pour les systèmes * nix. Certains dans les dépôts officiels, d'autres non, et chacun avec ses propres forces et faiblesses, mais en tant que téléspectateurs appropriés, je voudrais souligner ceux-ci:

  • Typora : Il est toujours en phase bêta, mais il est gratuit pendant ce temps (on ne sait pas comment sera licenciée la version stable). Bien qu'il ne soit pas FOSS, il est parfait comme visualiseur de démarques car il fonctionne par défaut presque comme un éditeur WYSIWYG ("mode de prévisualisation en direct") avec un panneau Outline (table des matières) qui est très pratique pour les gros fichiers. Le "mode code source" a une coloration syntaxique, y compris des polices plus grandes pour les en-têtes et des italiques pour l'accentuation. Et pas seulement exporter en HTML, ODT et PDF. Peut également importer-exporter vers plusieurs formats via l'intégration pandoc.

  • Ghostwriter : aperçu HTML uniquement (non modifiable) mais également un panneau de contour Nice et une coloration syntaxique. Sans options d'importation, mais exportez vers plusieurs formats avec des processeurs pandoc et autres (MultiMarkdown, Discount ou cmark) et bénéficiez d'une vérification orthographique en direct via hunspell/myspell.

  • MdCharm : Similaire à Retext, mais supporte le démarque (démarque supplémentaire) et MultiMarkdown. Affiche également un panneau Contour (ToC).

Pour R Markdown utilisateurs, je devrais également mentionner editR . N'est pas un programme, mais un package R pour éditer/aperçu html de R Markdown dans un navigateur. R Commander et RStudio permettent également un aperçu facile en HTML, PDF ou Word.

30
Fran

Pour ceux qui préfèrent w3m (fixations de style vi):

pandoc file.md | w3m -T text/html

Je l'ai mis dans un script, mdview.sh, et l'ai mis sur mon chemin:

#!/bin/sh
pandoc "$1" | w3m -T text/html
13
neildaemond

Utilisez la commande mdless gem /. Il affiche bien un fichier Markdown dans le terminal.

gem install mdless

Ensuite, exécutez

mdless README.d

enter image description here

Liens:

9
Simon Woodside

Il y a aussi Discount, l'implémentation C de David Parsons du texte Markdown de John Gruber en langage html. La remise se compose de plusieurs outils de ligne de commande, notamment markdown, mkd2html, makepage, mktags et theme.

http://www.pell.portland.or.us/~orc/Code/discount/

De plus, il y a une implémentation de markdown en C, en utilisant une grammaire PEG.

https://github.com/jgm/peg-markdown

Sur Mac OS X, vous pouvez également consulter qlmarkdown, un générateur QuickLook pour les fichiers Markdown.

4
carlo

Je sais que vous avez dit que vous préfériez une application non graphique, mais je travaille actuellement sur une application graphique appelée DownMarker qui le fait. Vous pouvez trouver la source dans un référentiel Mercurial ici . Vous pouvez trouver un exécutable autonome à exécuter avec mono ou .NET ici .

Attention: il est loin d'être terminé et n'a été testé qu'occasionnellement sur linux/mono. Le dernier test que j'ai fait était sur Mono 2.6. Si vous voulez le construire vous-même, vous aurez besoin d'une version récente de Mercurial pour cloner le référentiel, et MonoDevelop pour compiler l'application.

3
Wim Coenen

Utilise actuellement mdp dans Arch Linux et Termux sur Android, un outil de présentation de démarques.

image

Utilisation 

$ mdp {file}.md

Alias ​​lisse 

md() {
  fileName=${1:-"README.md"}
  mdp "$fileName"
}
3
A1rPun

Quelques commentaires ont demandé ou mentionné la possibilité d'utiliser un module complémentaire de navigateur. J'aime cette approche car je peux éditer des fichiers de démarques dans n'importe quel éditeur de texte Linux (de nano à vim en passant par Kate) et afficher les fichiers dans Firefox (mon navigateur de choix).

J'ai simplement installé ce module complémentaire Firefox et cela a fonctionné hors de la boîte sur Kubuntu 12.04 et Firefox 33.0. Aucun ajustement requis.

Markdown Viewer :: Modules complémentaires pour Firefox
https://addons.mozilla.org/en-us/firefox/addon/markdown-viewer/

(J'aime aussi ReText, mais je préférerais voir quelque chose comme ReText implémenté en tant que plugin pour Kate. ReText manque trop de fonctionnalités pour rivaliser avec des éditeurs matures comme Kate.)

3
MountainX

2 autres outils:
- Showdown est le port JavaScript ou Markdown: https://github.com/coreyti/showdown . Vous pouvez l'utiliser uniquement à partir du navigateur
- txt2tags peut lire le format Markdown mais il ajoute beaucoup de nouvelles options et fonctionnalités: http: // txt2tags. org/online.php

3
user2648

Un visualiseur de démarque en ligne de commande fortement sous-estimé à mon humble avis est le markdown-cli .

Installation

npm install markdown-cli --global

Usage

markdown-cli <file>

Caractéristiques

Probablement pas beaucoup remarqué, car il manque toute documentation ...
Mais autant que j'ai pu comprendre par quelques exemples de fichiers de démarque, certaines choses qui m'ont convaincu:

  • gère bien mieux les fichiers mal formatés (de la même manière que atom, github, etc.; par exemple lorsque des lignes vides manquent avant les listes)
  • plus stable avec un formatage dans les en-têtes ou les listes (le texte en gras dans les listes casse les sous-listes dans certains autres visualiseurs)
  • formatage approprié du tableau
  • coloration syntaxique
  • résout les liens de note de bas de page pour afficher le lien au lieu du numéro de note de bas de page (tout le monde ne le voudra peut-être pas)

Capture d'écran

example.png

Désavantages

J'ai réalisé les problèmes suivants

  • les blocs de code sont aplatis (tous les espaces de tête disparaissent)
  • deux lignes vides apparaissent devant les listes
3
orzechow

En supposant que vous souhaitiez voir à quoi ressemble le code HTML: utilisez un navigateur Web (avec un module complémentaire) comme visualiseur.

Par exemple, pour Google Chrome il y a TextDown qui vous permet également de modifier des fichiers directement dans le navigateur et de voir un aperçu en direct.

Après l'avoir ajouté, vous devez également accéder à chrome: // chrome/extensions/et cocher "Autoriser l'accès aux URL de fichier" pour pouvoir ouvrir les fichiers locaux. Un avertissement cependant: si vous enregistrez (shift-ctrl-s) TextDown n'enregistre pas dans le fichier que vous avez ouvert mais dans votre dossier de téléchargements.

2
PapaFreud

Readonly Vim avec mise en évidence et pliage Markdown

Avec mise en évidence et pliage de Vim Markdown opérationnel, la solution la plus simple consiste à évoquer vim en mode lecture seule avec vim -R, Ou (au moins sur Ubuntu ) plus élégamment:

$ view filename.md

Ajoutez ce qui suit tout en bas de votre fichier .vimrc Et view se comportera comme less avec l'avantage supplémentaire de votre coloration syntaxique préférée (pas seulement pour le démarquage!) et pliage:

" less behaviour for view
" https://unix.stackexchange.com/a/314184/39845

" http://vim.wikia.com/wiki/Using_vim_as_a_syntax-highlighting_pager
function! LessBehaviour()
    if (!&modifiable || &ro)
        set nonumber
        set nospell
        set laststatus=0    " Status line
        set cmdheight=1
        set guioptions=aiMr    " No menu bar, nor tool bar
        noremap u <C-u>
        noremap d <C-d>
        noremap q :q<CR>
    endif
endfunction

" https://vi.stackexchange.com/a/9101/3168
augroup ReadOnly
    au!
    au VimEnter * :call LessBehaviour() 
augroup END

Il existe également un script less.sh Plus rigoureux. Sur mon système, il est fourni avec vim. Pour le trouver, utilisez:

$ find /usr/share/vim -name less.sh

Cependant, contrairement au script ci-dessus, le pliage ne fonctionnera pas avec ce less.sh.

2
Serge Stroobandt

Je suggère de jeter un œil à Atom . C'est un excellent éditeur de texte avec un aperçu du démarquage intégré. Je n'utilise généralement pas le mode de prévisualisation du markdown car il présente un grave bug - des sauts de ligne (sauf s'ils viennent par paires, ce qui indique un <p> contenu de la balise) sont conservés dans l'aperçu. Mais le mode de mise en évidence de la syntaxe est si bon (puisque Markdown est optimisé pour être lisible par l'homme et la colorisation d'Atom est excellente) que je finis généralement par lire les fichiers de démarque en mode d'affichage source.

2
wingedrhino

Voici un script de ligne de commande qui ouvre un fichier de démarque dans votre navigateur après l'avoir converti en html: http://minhajuddin.com/2012/03/16/markdown-viewer-script-for-your-markdown- documents /

1
Khaja Minhajuddin

Vous pouvez jeter un œil à mad qui est très facile à utiliser:

mad file.md
1
Thomas Baruchel

Il s'agit d'un alias qui encapsule une fonction:

alias mdless='_mdless() { if [ -n "$1" ] ; then if [ -f "$1" ] ; then cat <(echo ".TH $1 7 `date --iso-8601` Dr.Beco Markdown") <(pandoc -t man $1) | groff -K utf8 -t -T utf8 -man 2>/dev/null | less ; fi ; fi ;}; _mdless '

Explication

  • alias mdless='...': Crée un alias pour mdless
  • _mdless() {...};: crée une fonction temporaire à appeler par la suite
  • _mdless: À la fin, appelez-le (la fonction ci-dessus)

A l'intérieur de la fonction:

  • if [ -n "$1" ] ; then: Si le premier argument n'est pas nul alors ...
  • if [ -f "$1" ] ; then: Aussi, si le fichier existe et est régulier alors ...
  • cat arg1 arg2 | groff ...: cat envoie ces deux arguments concaténés à groff; les arguments étant:
    • arg1: <(echo ".TH $1 7 date --iso-8601 Dr.Beco Markdown"): quelque chose qui démarre le fichier et groff comprendra les notes d'en-tête et de pied de page. Ceci remplace l'en-tête vide de la touche -s Sur pandoc.
    • arg2: <(pandoc -t man $1): le fichier lui-même, filtré par pandoc, produisant le style de fichier man$1
  • | groff -K utf8 -t -T utf8 -man 2>/dev/null: Rediriger le fichier concaténé résultant vers groff:
    • -K utf8 Donc groff comprend le code du fichier d'entrée
    • -t Pour qu'il affiche correctement les tableaux dans le fichier
    • -T utf8 Afin qu'il s'affiche au format correct
    • -man Donc il utilise le package MACRO pour sortir le fichier au format man
    • 2>/dev/null Pour ignorer les erreurs (après tout, c'est un fichier brut transformé à la main par l'homme, nous ne nous soucions pas des erreurs tant que nous pouvons voir le fichier dans un format pas trop laid) .
  • | less: Enfin, montre le fichier qui le pagine avec less (J'ai essayé d'éviter ce tube en utilisant groffer au lieu de groff, mais groffer n'est pas aussi robuste que less et certains fichiers le bloquent ou ne s'affichent pas du tout. Alors, laissez-le passer par un autre tuyau, qu'est-ce que ça fait!

Ajoutez-le à votre ~/.bash_aliases (Ou similaire)

0
Dr Beco

Moeditor

Je suis juste tombé aujourd'hui sur cet éditeur de démarque agréable, simple et efficace:

https://moeditor.js.org/

0
woohoo

Facile et disponible dans probablement tous les repo de packages de distribution Linux. Vous aurez besoin des packages "pandoc", "w3m" et "w3m-img". Avec le dernier w3m peut afficher des images.

pandoc -f markdown -t html README.md | w3m -T text/html

'-f markdown' est facultatif. Cela vous donnera un aperçu assez agréable avec des images directement dans la fenêtre du terminal, le seul inconvénient est que vous ne pouvez pas vraiment distinguer les blocs de code en ligne.

0
skidnik

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.

0
aap

La façon la plus indolore pour moi est d'utiliser mdless gem de Ruby.

  1. Installez Ruby

    Sudo apt-get install Ruby

  2. Installer mdless

    Sudo gem install mdless

  3. Ouvrir un fichier via mdless

    mdless filename.md

0
Jonel Dominic Brave