Quale file utilizza l'estensione .md e come devo modificarli?

879

Su GitHub, diversi progetti hanno README.mdfile. Sembra un semplice file di formato per esprimere testo e immagini.

Immagino che ci sia un editor o una spiegazione della sintassi da qualche parte.

Dove posso trovare un'introduzione ai .mdfile?

markdown  file-extension 
— Lai Yu-Hsuan
fonte
38
Immagino che questa sia una prova a favore dell'utilizzo .markdowndell'estensione, anche se è così terribilmente lungo ...
— endolith
7
Ecco un link che può aiutarti -> .MD File Extension
— Vipin Kr. Singh,
1
MarkPad è una bella applicazione per l'editing di MarkDown in Windows. Ti presenta l'anteprima delle modifiche.
— skjoshi,
1
L'utente può provare MarkView , un'estensione di Chrome per la modifica e la visualizzazione del file markdown all'interno del browser.
— swcool,
1
Guida completa per aiutarti a iniziare con markdown: blog.wax-o.com/2014/04/… . Dovresti provare a scrivere markdown con un modo di vivere visualizzando il risultato (con un'applicazione come mouapp.com ). Sapevi che la sintassi di post e commenti stackoverflow si basa sul markdown? :) stackoverflow.com/editing-help
— fabien

Risposte:

733

Markdown è un formato di file di testo semplice. Le estensioni .mde .markdownsono solo file di testo scritti nella sintassi di Markdown . Se hai un Readme.mdrepository nel tuo repository, GitHub mostrerà i contenuti nella home page del repository. Leggi la documentazione:

Puoi modificare il Readme.mdfile in GitHub stesso. Fai clic su Readme.md, troverai un pulsante di modifica. È possibile visualizzare in anteprima le modifiche e persino eseguirle da lì.

Poiché si tratta di un file di testo, Notepad o Notepad ++ (Windows), TextEdit (Mac) o qualsiasi altro editor di testo può essere utilizzato per modificarlo e modificarlo. Esistono editor specializzati che analizzano automaticamente il markdown mentre lo digiti e generano un'anteprima, mentre altri applicano vari colori di sintassi e decorazioni al testo visualizzato. In entrambi i casi, tuttavia, il file salvato è ancora un file di testo leggibile.

Se si desidera creare un mdfile con preview e se si preferisce non installare alcun editor speciali, è possibile utilizzare gli editor online come dillinger.io e stackedit.io . Forniscono un'anteprima dal vivo. Puoi anche esportare i tuoi file su Google Drive o Dropbox .

— Dikei
fonte
27
Ho trovato la spiegazione di base di Github molto utile anche come introduzione rapida.
— Voo
2
Su Windows potresti voler usare WordPad per usare la formattazione per una lettura più facile.
— G O'Rilla,
4
@ GO'Rilla, IMHO evita WordPad come la peste a meno che non ti scriva piccole note che non condividerai mai con nessuno. Ciò che aggiunge al file .txt può provocare il caos su altri editor (vim, Notepad ++, ecc.). Molto meglio lavorare in testo normale quando si ha a che fare con .txt e usare un elaboratore di testi o Acrobat per file testuali non .txt come .doc e .pdf.
— labirinto
1
possiamo aggiungere immagini o tramite link nel file .md ... è possibile?
— Raffaello,
1
@ user1645290 Sì, è possibile. vedi
— B-GangsteR,
87

Se stai cercando un editor, ti suggerisco di utilizzare http://dillinger.io/ . È un semplice editor di testo basato su browser che può rendere Markdown al volo.

Tuttavia, se preferisci un'app e stai utilizzando OS X, puoi provare Mou . È abbastanza buono e pieno di esempi.

— sirLisko
fonte
2
Sembra essere tornato alla vita?
— GuiSim
5
Vorrei suggerire http://dillinger.io/ , un altro editor di testo basato su browser davvero interessante. Ti consente anche di collegare Dropbox, Github e Google Drive.
— sirLisko,
Il link Blocco note in questa risposta avvia il download di un file RAR. Perché non c'è una pagina web, non hai detto che era un editor basato su browser?
— evanrmurphy,
quel collegamento non è più valido
— Carlos Pliego,
Basta sottolineare che questa non è una risposta completa alla domanda. Non spieghi cos'è .md, solo come può essere modificato
— Zoe,
44

L' editor di testo Atom di Github ha una modalità di anteprima live per i file di markdown.

La scorciatoia da tastiera è CTRL+SHIFT+M.

Può essere attivato dal l'editor utilizzando la CTRL+SHIFT+Mchiave vincolante ed è attualmente abilitata per .markdown, .md, .mkd, .mkdown, e .ronfile.

inserisci qui la descrizione dell'immagine

— Feckmore
fonte
33

L' editor di testo di Visual Studio Code di Microsoft ha integrato il supporto per i file .md scritti nella sintassi di markdown.

La sintassi viene automaticamente codificata per colore all'interno del file .md e una finestra di anteprima del markdown renderizzato può essere visualizzata premendo Shift+Ctrl+V(Windows) o Shift+Cmd+V(Mac).

Per vederli fianco a fianco, trascina la scheda di anteprima sul lato destro dell'editor o usa invece Ctrl+K V(Windows) o Cmd+K V(Mac).

inserisci qui la descrizione dell'immagine

VS Code utilizza la libreria contrassegnata per l'analisi e ha il supporto Markdown aromatizzato Github abilitato per impostazione predefinita, ma non visualizzerà Github Emoji in linea come l' editor di testo Atom di Github .

Inoltre, i supporti VS Code hanno diversi plug-in di markdown disponibili per funzionalità estese.

— Feckmore
fonte
Se stai usando Visual Studio 2015 invece vedi la mia risposta di seguito.
— bytedev,
1
Nota: è possibile fare clic con il pulsante destro del mouse sul file Leggimi> apri anteprima
— Chris Halcrow il
15

L'estensione ' .md ' si riferisce ai file Markdown .

Se non vuoi installare un'app per leggerle in quel formato, puoi semplicemente usare TextEdit o Xcode stesso per aprirlo su Mac.

Su qualsiasi altro sistema operativo, dovresti essere in grado di aprirlo utilizzando qualsiasi editor di testo , sebbene, come previsto, non lo vedrai in formato Markdown .

— codeburn
fonte
4
In realtà, lo vedrai in formato Markdown. Tuttavia, non lo vedrai come grassetto, corsivo, trattini e blocchi di codice.
— Corse di leggerezza in orbita
14

Sì, solo Markit al gusto di GitHub . Includere un file README nel repository aiuterà gli altri a determinare rapidamente di cosa si tratta e come installarlo. Molto utile da includere nei tuoi repository.

— esilvas
fonte
5
Downvoted. Con "uno" in "incluso uno nel tuo repository" dovresti dire "un file README in qualsiasi formato", non solo "un file README.md". Ma la domanda è sui file ".md" in generale, non sui file README in generale. Quindi questa risposta è irrilevante per la domanda. Inoltre, l'ambiguità con "uno" potrebbe indurre un lettore a pensare che i README di Markdown siano necessariamente migliori degli altri README, il che è sbagliato.
— Rory O'Kane,
1
Ho apportato la modifica specificata nel commento precedente, perché ha senso e penso che potrebbe aiutare a evitare confusione. Non penso che questa sia un'ottima risposta, poiché non aggiunge nulla di nuovo che sia rilevante. Questa domanda non riguarda README, si tratta dell'estensione .md. Non c'è motivo di aggiungere questa risposta sei settimane dopo che la risposta accettata ha fornito le stesse informazioni.
— Erick Robertson,
5

Stack Edit è un editor di markdown online con la possibilità di salvare su Google Drive e DropBox.

— Philip
fonte
5

Markdown è solo un file di testo che ha facoltativamente .mdo .markdownestensioni. Può essere convertito in HTML. Per conoscere la sintassi di Markdown, controlla

GitHub Flavored Markdown .

È possibile utilizzare qualsiasi editor di testo per il markdown. Se sei un sublime textutente, puoi dare un'occhiataMarkdown Preview plug-in che visualizzerà il contenuto di markdown renderizzato nel browser e si aggiornerà ogni volta che cambi il file di markdown.

Alcuni dell'editor di markdown online

— Fizer Khan
fonte
3

Suggerisco StackEdit . È un semplice editor WISIWIG. È possibile utilizzare la sintassi dell'editor e del markdown. C'è una sintassi di aiuto markdown veloce lì. Annulla / ripristina, commenti, GoogleDrive, interconnessione Dropbox.

— Romeno
fonte
2

Se stai creando file .md per le tue soluzioni .NET, ti consiglio l' Editor Markdown Editor di Visual Studio 2015 in quanto ha un pannello di anteprima in modo da poter vedere le tue modifiche in tempo reale.

EDIT : anche questo ora dovrebbe funzionare con Visual Studio 2017.

— bytedev
fonte
0

La cosa più semplice da fare, se non si dispone di un lettore, è aprire il file MD con un editor di testo e quindi scrivere il file MD come file HTML e quindi fare doppio clic per visualizzarlo con il browser.

— richardwendrock
fonte
Funzionerà solo se hai un plugin che legge i file .md.
— Brad Bruce,
0

Il .md sta per Markdown Text. Fondamentalmente, è solo un altro tipo di file di testo, come .txt

Uso Notepad ++ per leggere e modificare questi

— NocFenix
fonte
Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.