Exibir arquivos de remarcação offline [fechado]


609

Existe uma maneira de exibir .mdarquivos off-line para que saibamos como será o upload do Github? Refiro-me a mostrar o README.mdarquivo como seria lançado no Github, e não para fins de edição.

Precisa trabalhar no Mac e Windows desde que eu use os dois.

Respostas:


428

Existem alguns plug-ins do Chrome que funcionam bem. Estou usando o Markdown Preview Plus .

Após a instalação, ative "Permitir acesso aos URLs dos arquivos" em Extensões (menu> Mais ferramentas> Extensões ou insira o URL chrome://extensions/).

insira a descrição da imagem aqui

Em seguida, arraste e solte um arquivo Markdown no Chrome e use seu editor favorito para editar.


3
obrigado, uma extensão do Chrome sempre seria útil; há necessidade de usar software extra
Avi

37
Obrigado! Instalado e não conseguia descobrir por que os arquivos md não estavam sendo renderizados corretamente - o 'Permitir acesso ...' era a chave.
mattezell

1
Não Markdown visualização não suportam blocos de código
acíclico

2
Para ser mais específico, quando o Markdown Preview encontra `` `', ele coloca todas as linhas no bloco de código em uma única linha. Então, eu tentei o Markview mencionado pelo swcool. O estilo não corresponde completamente ao github, mas pelo menos coloca cada linha no bloco de código em linhas separadas.
EL Rayle

2
Mudou de Markdown Preview para Markdown Preview Plus porque corrige blocos de código e muito mais. Editou minha resposta acima para refletir isso.
21915 Jim

256

Escrevi Grip há um tempo atrás para fazer exatamente isso. É renderizado exatamente como no GitHub e fornece várias opções adicionais também:

  • Além dos READMEs, o Grip pode renderizar comentários e questões do GitHub
  • Clique nos links locais para renderizar outros arquivos .md
  • Uma API para usar em seus próprios projetos
  • Exportar para um arquivo HTML

Instale com pip:

pip install grip

Em seguida, vá para o diretório que contém o arquivo README e execute:

grip

Passe -hpara obter ajuda e opções adicionais.

Aqui está uma captura de tela do Grip renderizando o README do Grip:

Captura de tela do Grip rendering Grip

Espero que isto ajude. Confira aqui .


2
@luchosrock Você poderia postar uma essência do Markdown que não é renderizada corretamente? Se houver alguma incompatibilidade, arquivarei um bug e o corrigirei.
Joe

2
@luchosrock Eu acho que você pode estar confundindo os dois. A partir dos documentos do próprio gfms, "a implementação atual do GFMS não colore os blocos de código-fonte", enquanto o Grip sim. O Grip usa a API Markdown do GitHub e cria estilos prontos para uso, não uma solução personalizada, que é o que torna o Grip tão preciso. Além disso, o gfms é baseado em , não em Python.
Joe

2
Ao contrário de outras soluções, funciona como um encanto no Linux! Obrigado!
akhmed 15/09/2015

5
Leve e adorável. Obrigado!
Benjamin R

2
@ Joe Acabei de descobrir isso por mim. Ótimo trabalho. Funciona lindamente.
Idjaw

106

Atom do Github. Fornece uma visualização lado a lado.

insira a descrição da imagem aqui

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


2
Isso é bom se você estiver editando muitos arquivos .md. E a visualização instantânea, sem precisar alternar para outro aplicativo, é sempre uma vantagem.
Dval

Existe até um pacote de rolagem automática: github.com/mark-hahn/markdown-scroll-sync . Atualmente, você precisa corrigir o github.com/mark-hahn/markdown-scroll-sync/pull/66/files para que funcione sem avisos.
Dror

1
Esta também é uma boa sugestão. A visualização instantânea com o painel lado a lado é um bônus! Não há necessidade de salvar e sair constantemente.
AnimNations

O link na parte inferior da sua resposta não existe
xxx ---

64

Código do Visual Studio - o novo editor da Microsoft também oferece muito bom suporte para edição de descontos.
Você pode baixá-lo aqui .
O editor fornece um bom suporte para alternar entre o código de remarcação e o modo de visualização .
Ele também fornece um suporte inteligente razoavelmente bom para toda a sintaxe de remarcação.
O editor é gratuito para uso e também é multiplataforma (funciona no Linux, Windows e Mac).
Para mais detalhes, você pode conferir no site deles .

insira a descrição da imagem aqui


2
Impressionante e mais fácil!
Mayur Patil

2
Excelente sugestão. O MS Visual Code é uma ferramenta INCRÍVEL , para muitas coisas diferentes, em muitos contextos diferentes. É grátis; roda em Windows, Linux e MacOS.
paulsm4

1
Legal, uma solução que eu já tinha instalado! Eu tinha duas pequenas coisas para descobrir: Para abrir o painel de visualização, clique com o botão direito do mouse na guia do arquivo na parte superior e selecione "Abrir visualização (Ctrl? Shift + V)". Para invocar o intellisense mencionado pelo @sundeep, pressione Ctrl + Space na janela do editor.
Arichards 20/01/19

3
ctrl + kv para visualizar
aderchox 17/05/19

62

Tarde para a festa, mas dê uma olhada no MarkdownPad .


21
Se você deseja obter suporte para descontos no github, precisará obter o MarkdownPad Pro - por ~ 15USD. Eu pessoalmente pagaria talvez 5 USD por isso, mas com certeza não 15 USD. Portanto, se alguém puder recomendar outra coisa, faça-o.
burzum

4
Paguei apenas US $ 15 pela versão pro, vale a pena, mas seria bom se funcionasse com o Mono, para que eu pudesse usá-lo no linux / osx, que é o lugar para onde mais do meu desenvolvedor está indo atualmente.
precisa

O MarkdownPad parecia ter entrado em naftalina há um tempo, então eu (alerta de divulgação: sim, eu fiz e vendi isso) fiz o MarkUpDown , que não é muito ruim em US $ 15. Deve ser amigável ao GitHub Markdown e, se não estiver, deixe-me saber como não é e vou consertá-lo.
Ruffin

37

Veja Python-Markdown-Editor

É baseado em:

  • Python-Markdown
  • Pigmentos (destaque da sintaxe do bloco de código)
  • CodeMirror (editor de código javascript)
  • Garrafa

Instale com pip:

$ pip install markdown-editor 

Possui visualização quando você digita, destaque de código, blocos de código cercados, estilo github

pode ser usado por linha de comando:

$ markdown_edit 

$ markdown_edit README.md

$ markdown_edit -f readme.html README.md

insira a descrição da imagem aqui

Eu criei isso para criar uma ferramenta para enviar revisões de código, é facilmente extensível, importando-a como um módulo, você pode adicionar ações personalizadas.


Olá, este parece ser um ótimo aplicativo, no entanto, não consigo abrir dois arquivos .md ao mesmo tempo, pois na maioria das vezes eu só quero que seja um visualizador e não um editor. Você estenderá isso com sintaxe como localhost: 8000 / <caminho / para / arquivo.md > para permitir a exibição de vários arquivos .md?
arcticfox

Você pode editar vários arquivos com -p <port>opção
Nicolas Cornette

dá um erro Traceback para mim
aderchox

29

Acabei de instalar https://github.com/ypocat/gfms . Ele faz um bom trabalho ao renderizar uma remarcação com sabor do github. Ele detecta alterações na sua remarcação, então basta colocar o navegador e o editor lado a lado. Como o Node.js, deve funcionar bem em qualquer plataforma.

Se você tiver o Node.js instalado, a instalação é simples:

  1. sudo npm install -g gfms
  2. gfms --port 9999 (no diretório do seu projeto)
  3. http://localhost:9999/ (aberto com qualquer navegador)

Infelizmente, gfmsnão renderiza quebras de linha da maneira que o GFM faz - ele não insere uma linha quando há uma única quebra de linha dentro de um parágrafo, como faz o GFM. Mas para renderização "pura" do Markdown, tudo bem.
Ed Ruder 28/05

2
Há uma versão atualizada do gfms ( github.com/pawel-wiejacha/gfms ) que usa melhor back-end do GFM Markdown (marcado) e insere quebras de linha corretamente. Ele também aprimorou as listagens de diretórios e o recurso de exportação de PDF.
Pawel Wiejacha

5
Eu tentei isso porque parecia promissor. Teve que instalar o node.js (esperado), mas também o python. Desisti quando queria uma cadeia de ferramentas completa para desenvolvedores em C ++. Portanto, dependendo da sua plataforma, pode ser fácil, mas se você estiver no Windows, nem tente esta sugestão.
Chase

Praticamente nada escrito no NodeJS funciona no Windows. Quando um guia "instalar este software" começa com "npm install", aprendi a maneira mais difícil de simplesmente ir embora. O NodeJS não é tão multiplataforma quanto os desenvolvedores gostariam que as pessoas acreditassem. Golang e Python são igualmente ruins, mas não tão ruins quanto o Node. A única linguagem de script que eu conheço é realmente multiplataforma e funciona em qualquer lugar com o mínimo de esforço e não requer a instalação de centenas de MB de lixo eletrônico é o PHP. A CLI do PHP é uma jóia escondida - é melhor como uma linguagem de script de linha de comando do que qualquer outra coisa lá fora.
CubicleSoft 19/18

27

Eu encontrei uma maneira de vê-lo em PHP. Depois de bisbilhotar, encontrei 2 soluções para visualização offline e online de arquivos .md:

Eu recomendo a versão off-line para que você possa fazer sua edição mesmo quando estiver negociando no trono. :)


1
Existem muitos aplicativos de área de trabalho para exibir .mdarquivos também.
23412 Matt Ball

Eu não sabia disso. O que eles são?
enchance 23/03


@enchance, por que PHP? Uma versão javascript seria melhor.
Pacerier 15/07

23

Há pessoas que não usam o Google Chrome. Existe um complemento do Firefox chamado Markdown Viewer, capaz de ler arquivos Markdown offline.


1
Bom, e aqui está um novo link para WebExtensions (ff 57+).
Sam

Estou esquecendo de algo? Ele diz "Atualmente, arquivo: // URLs não são suportados!" - esse tipo de desqualificação não é uma solução? Além disso, muitas críticas de uma estrela dizem que a Webext não funciona.
Mitch

19

você já experimentou o ReText ? É um bom editor de Markdown para desktop


tantas dependências. mas parece bom o suficiente!
DMEU

Algumas informações sobre como instalar o reText no Mac OS X podem ser encontradas aqui #
lauhub 6/14

1
Pode ser necessário instalar algumas dependências manualmente para ele: sudo apt-get install python3-docutils python3-markdown
Konstantin Smolyanin

Tudo é configurado automaticamente no Ubuntu 15.04, tanto as dependências quanto a associação do tipo mime.
colan

1
@Moytaba Parece que foi movido para o github: github.com/retext-project/retext
NuclearPeon

17

O pandoc é uma boa ferramenta de conversão de texto em texto que resolve o problema da visualização offline do seu Markdown. Basta emitir:

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

Apenas instalei e usei em alguns arquivos. Funciona bem!
Edward

14

Achei a extensão MarkView Google Chrome bastante útil, na verdade, está funcionando como um encanto:

O MarkView é uma extensão do Chrome para editar e visualizar arquivos de remarcação com uma visualização de estrutura de tópicos, suporta vários estilos de formato de tabela, destaque da sintaxe do bloco de código e remarcação com sabor do Github.

Recursos:

  1. Edição e visualização do arquivo de marcação no estilo de página da web.
  2. Recarregar automaticamente o arquivo local quando o arquivo é alterado ( Pós-instalação: selecione a opção "Permitir acesso aos URLs dos arquivos" no chrome: // extensions / )
  3. Mostrar contorno ao lado do conteúdo de maneira rolável
  4. Possui botões para GoTop, ViewSource e GoBottom
  5. Suporte os estilos de tabela com desconto do Github e o destaque do código.
  6. Destaque a área de código para linguagens de programação (por exemplo, `` ruby)
  7. Suporte para impressão de páginas da Web com uma perspectiva decente (Chrome-> Arquivo-> Imprimir ...)
  8. Responsivo: quando o tamanho da janela for menor que 940px, a seção de tópicos será ocultada automaticamente; redimensionar maior que 940px, a seção de estrutura de tópicos será exibida.
  9. O MarkView exibirá todos os arquivos de remarcação, exceto aqueles em raw.github.com, porque esse subdomínio exibe apenas a fonte.

Mais recursos foram adicionados ao MarkView:

  1. Editor de remarcação WYSIWYG
  2. Seleção de Temas e Estilo de Código
  3. Notas de rodapé de suporte 1
  4. Apresentação instantânea de slides
  5. Estilo de documento personalizado

    • Adicione CSS de tema e selecione
    • Adicionar estilo de código e selecionar
    • Escreva CSS, salve e execute

@swcool Se você acha que tem uma resposta melhor, crie sua própria, em vez de editar outras pessoas.
Jason

Acredito que o @swcool é o autor da extensão do Chrome acima mencionada, ele está apenas atualizando-a?
mariomaric

Sim, sou o autor desta extensão do Chrome. Eu gosto de atualizar a descrição acima sempre que a extensão tiver sido adicionada a mais recursos novos. Dessa forma, o MarkView pode ser mantido em um local de resposta em uma pergunta. Sim, atualize apenas. Mas parecia que o sistema Stackoverflow não aprovou minha atualização, então tenho que parar. @ Jason
swcool


11

Você pode usar textos como visualizador e editor de md, leve e organizado. insira a descrição da imagem aqui


1
Este é um editor de qualidade, obrigado pelo aviso!
Lea Hayes

23
Não é gratuito: textos.io/compra
TN.

4
Também não está disponível para Linux.
Jameshfisher

4
Achei isso para renderizar muitos arquivos md bastante mal.
Zv_oDD 26/09

2
No mac, é necessário pré-instalar alguma ferramenta externa "fandoc", que eu não conheço ou confio, especialmente que ela esteja em algum lugar do meu sistema operacional. O próprio wrapper (Textos) pesa cerca de 4 MB, o que é muito grande para um renderizador .md, mesmo sem a ferramenta externa ... bem, o aplicativo não é tão impressionante.
Motti Shneor

11

O Geany possui um plug - in para descontos, que faz um bom trabalho, oferecendo também uma prévia do desconto na barra lateral. Também roda em Linux, Mac OS X e Windows.

Para usá-lo, instale o geany, instale o pacote geany-plugin-markdown e selecione-o no gerenciador de plugins.


Eu uso geany para todos e esta é a resposta que eu estava esperando :)
Rutrus

9

Acabei de codificar um visualizador de descontos offline usando o observador de arquivos node.js e o socket.io, para que você aponte seu navegador para localhost e execute ./markdownviewer /path/to/README.mde o transmita para o navegador usando websockets.


Arrumado. Resisti ao node.js até agora, mas queria dar uma olhada e esse foi um bom motivo. O estilo não é perfeito, talvez um arquivo css do github ausente deva ser inserido pelo visualizador?
Pduey

8

Há também o StackEdit . Funcionará online e offline (usa o armazenamento local do navegador).

Você também pode conectá-lo ao Dropbox ou ao Google Drive para ver os arquivos hospedados na nuvem.


4
O armazenamento do navegador é muito limitado. Muito, muito limitado.
Pacerier

8

Se você é uma pessoa vim, pode experimentar o plugin vim-preview . Simplesmente instale-o no seu ~/.vimdiretório com o seu método de escolha. Em seguida, você pode abrir um arquivo Markdown com o vim e usar o comando :Previewque abrirá uma nova janela no seu navegador e exibirá o resultado final.


Obrigado! Infelizmente, o plug-in requer um interpretador de rubi embutido e algumas gemas. Dependências demais para mim ...
xverges

1
Sim, desculpe por isso - eu o instalei há um tempo, então esqueci de mencionar as gemas de rubi (para futuros leitores: o link do plug-in que eu incluí acima descreve como resolver isso se você gosta desse tipo de rubi) .
Peter Diakumis

1
Outra vim plugin, este usando javascript: github.com/suan/vim-instant-markdown
matiasg

7

Considere Strapdown .

O Strapdown é uma solução baseada em Javascript que renderiza o conteúdo de descontos no navegador, o que o torna ótimo para visualização offline. A partir de sua própria descrição:

O Strapdown.js facilita a criação de documentos Markdown elegantes. Nenhuma compilação do lado do servidor necessária.

Então, renomeie seu .mdarquivo de remarcação para .htmle envolva-o com:

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

e a abertura em qualquer navegador mostrará o HTML renderizado. Bônus adicionado: você pode facilmente mudar o tema.


5

Para MAC, uso Marcado , para Windows, uso Muto-Mark . Ambos suportam a folha de estilo GH.


+1: estou usando o MutoMark para Windows: 1. É muito leve (395 KB) 2. Visualizador agradável 3. Capacidade de pesquisa (Ctr + F) 4. Destaca todos os resultados da pesquisa
Iman Mahmoudinasab 17/13/13

1
que infelizmente não parece associação de arquivo apoio
draeron

4

Para o OS X, o Mou é muito bom e vem com dois temas CSS do GitHub.


Bom, mas com buggy. Por exemplo, você remove as marcas de cabeçalho ###, mas a parte WYSIWYG ainda a mostra como cabeçalho. E assim por diante, acho que encontrei 3 ou 4 bugs em 2 minutos de uso.
Mjuba

4

Confira Haroopad . Este é um ótimo editor de #markdown. É gratuito e está disponível para várias plataformas. Eu tentei no Mac OSX.


Esta análise de muitos editores do WYSIWYG concluiu que o Haroopad era o melhor. Também está disponível para Windows e Mac. Acabei de fazer o download para editar um wiki do projeto GitHub e até agora parece muito bom.
quer

4

Um dos recursos mais simples que funciona bem no MacOSX é o plugin Markdown Quick Look, encontrado no InkMark . Após a instalação no OS X 10.9+, basta selecionar um arquivo de remarcação no Finder e tocar na barra de espaço. Não tenho certeza se os resultados estão correlacionados 100% com o Github, mas eles são muito bons e contribuem para uma solução minúscula e discreta para visualizadores offline. Mashable também escreveu um artigo sobre 78 ferramentas diferentes, se você quiser outras opções.

Makrdown-QuickLook-Preview


1
O MELHOR DE TODOS. Posso contar o número de vezes que selecionei um arquivo .md e acertei o espaço, apenas para dar uma pequena maldição - em centenas, talvez milhares. Eu então "e" abro com Mou ", espera, fecha o lado da edição - porque a visualização lado a lado é feita para edição e é apenas um incômodo ao ler um arquivo .md.
Motti Shneor

4

Uma solução fácil para a maioria das situações: copie / cole a marcação em um visualizador na "nuvem". Aqui estão duas opções:

  1. Dillinger.io
  2. Dingus

Nada para instalar! Plataforma cruzada! Navegador cruzado! Sempre disponível!

Desvantagens: pode ser incômodo para arquivos grandes, problemas de segurança padrão de aplicativos em nuvem.


E, claro, você está compartilhando seus documentos de pré-lançamento com o mundo inteiro, antes mesmo de ser capaz de prova eles ...
Motti Shneor

3

Você pode usar a extensão chamada Markdown Syntax Highlighting for Notepad ++. Está disponível no Github

insira a descrição da imagem aqui

Após a instalação, uma nova opção no menu suspenso Idioma será exibida. Após a instalação, uma nova opção no menu suspenso Idioma será exibida.


1
Emocionante. Você pode adicionar um link ao Github?
Smandoli 31/03

3
Isso não responde à pergunta. O objetivo é mostrar o resultado final, não a fonte.
Deryck


2

O RStudio pode lidar com arquivos de descontos e convertê-los em html e pdf. Se você já o possui, pode usar o RStudio (é uma linguagem de programação IDE para R). É gratuito e de código aberto, e funciona em Windows, Mac e Linux.


1

Você pode usar o Scribefire Next.

É um plugin do navegador Mozilla Firefox . Basta instalar a extensão e inicie o Firefox. Personalize sua barra de ferramentas e coloque o atalho Scribefire nela. E como é um plug-in de navegador, você pode usá-lo em Mac, Linux e Windows.

Quando você deseja escrever no modo Markdown, basta clicar Edit Codena janela Scribefire.

Agora, para atingir seu objetivo, vá para o Edit Codemodo e copie todos os textos, cole-o no seu .mdarquivo e faça o upload.

Não há recurso de visualização ao vivo para isso, você precisa alternar Edit Codee Edit Visuallyvisualizar seu texto.

Estou usando-o na minha caixa Linux Mint:

insira a descrição da imagem aqui

insira a descrição da imagem aqui

Atualizar:

É ano de 2014, precisamos adicionar outra ferramenta incrível aqui para outros leitores e pesquisadores. Recentemente usei Brackets + Markdown Preview Extension .


Eu amo suportes !!! Nenhum spam, eu realmente faço
a7omiton


Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.