Markdown e Visual Studio Code

Lavorare con i file Markdown in Visual Studio Code è semplice, diretto e divertente. Oltre alla modifica di base di VS Code, ci sono una serie di funzionalità specifiche di Markdown che ti aiuteranno a essere più produttivo.

Estensioni Markdown

In aggiunta alla funzionalità VS codice fornisce fuori dalla scatola, è possibile installare un’estensione per una maggiore funzionalità.

Suggerimento: Clicca su una tessera di estensione sopra per leggere la descrizione e le recensioni per decidere quale estensione è meglio per voi. Vedi di più nel mercato.

Anteprima Markdown

Il codice VS supporta i file Markdown pronti all’uso. Basta iniziare a scrivere il testo Markdown, salvare il file con estensione .md e quindi è possibile alternare la visualizzazione dell’editor tra il codice e l’anteprima del file Markdown; ovviamente, è anche possibile aprire un file Markdown esistente e iniziare a lavorare con esso. Per passare da una vista all’altra, premi V V (Windows, Linux Ctrl+Maiusc+V) nell’editor. È possibile visualizzare l’anteprima side-by-side (K K V (Windows, Linux Ctrl+K V)) con il file che si sta modificando e vedere le modifiche riflesse in tempo reale durante la modifica.

Ecco un esempio con un file molto semplice.

Markdown Anteprima

Suggerimento: È anche possibile fare clic sulla Scheda editor e selezionare Apri Anteprima (⇧⌘V (Windows, Linux Ctrl+Shift+V)) o utilizzare il Comando Palette (⇧⌘P (Windows, Linux Ctrl+Maiusc+P)) per eseguire il Markdown: Apri Anteprima al comando laterale (K K V (Windows, Linux Ctrl + K V)).

anteprime Dinamiche e anteprima di chiusura

per impostazione predefinita, Markdown automaticamente le anteprime di aggiornamento per visualizzare in anteprima attivo Markdown file:

anteprima automaticamente la commutazione in anteprima la corrente Markdown documento

e ‘ possibile bloccare un Markdown anteprima con il Markdown: Selezione Anteprima comando di Blocco per tenerlo bloccato per la sua attuale Markdown documento. Le anteprime bloccate sono indicate da nel titolo:

Un'anteprima markdown bloccata

Editor e sincronizzazione anteprima

VS Code sincronizza automaticamente l’editor Markdown e i riquadri di anteprima. Scorri l’anteprima Markdown e l’editor viene fatto scorrere in modo che corrisponda alla finestra dell’anteprima. Scorrere l’editor di Markdown e l’anteprima viene fatta scorrere in modo che corrisponda alla sua finestra:

Selezione dell'editor di anteprima di Markdown scroll sync

È possibile disabilitare la sincronizzazione dello scorrimento utilizzando le impostazionimarkdown.preview.scrollPreviewWithEditor emarkdown.preview.scrollEditorWithPreview.

La riga attualmente selezionata nell’editor è indicato nel Markdown anteprima da una barra di colore grigio chiaro nel margine sinistro:

Markdown Anteprima editor di linea marcatore

Inoltre, fare doppio clic su un elemento nella Markdown anteprima si aprirà automaticamente l’editor per il file e selezionare la linea più vicina all’elemento selezionato.

Anteprima Markdown Il doppio clic passa all'editor

Vista struttura

La vista struttura è una sezione separata nella parte inferiore di Esplora file. Una volta espanso, mostrerà l’albero dei simboli dell’editor attualmente attivo. Per i file Markdown, l’albero dei simboli è la gerarchia di intestazione del file Markdown.

Markdown Outline view

La vista Outline è un ottimo modo per rivedere la struttura dell’intestazione e il contorno del documento.

Estendere l’anteprima di Markdown

Le estensioni possono contribuire con stili e script personalizzati all’anteprima di Markdown per modificarne l’aspetto e aggiungere nuove funzionalità. Ecco una serie di estensioni di esempio che personalizzano l’anteprima:

Usando il tuo CSS

Puoi anche usare il tuo CSS nell’anteprima di Markdown con l’impostazione"markdown.styles": . Questo elenca gli URL per i fogli di stile da caricare nell’anteprima Markdown. Questi fogli di stile possono essere URL https o percorsi relativi ai file locali nell’area di lavoro corrente.

per esempio, Per caricare un foglio di stile chiamato Style.css alla radice della vostra area di lavoro corrente, utilizzare il File > Preferenze > Impostazioni per visualizzare l’area di lavoro settings.json file e fare questo aggiornamento:

// Place your settings in this file to overwrite default and user settings.{ "markdown.styles": }

Tenere finale spazio per creare interruzioni di riga

Per creare interruzioni di linea, Markdown richiede due o più spazi alla fine di una riga. A seconda delle impostazioni dell’utente o dell’area di lavoro, il codice VS può essere configurato per rimuovere gli spazi bianchi finali. Per mantenere gli spazi bianchi finali solo nei file Markdown, puoi aggiungere queste righe al tuo settings.json:

{ "": { "files.trimTrailingWhitespace": false }}

Markdown preview security

Per motivi di sicurezza, il codice VS limita il contenuto visualizzato nell’anteprima Markdown. Ciò include la disabilitazione dell’esecuzione dello script e la possibilità di caricare solo le risorse su https.

Quando il Markdown anteprima i blocchi di contenuto su una pagina, un avviso a comparsa viene visualizzato nell’angolo superiore destro della finestra di anteprima:

markdown avviso di sicurezza

È possibile modificare il contenuto è consentito in Markdown anteprima cliccando su questo popup o l’esecuzione di Markdown: Cambiare anteprima le impostazioni di sicurezza del comando, in qualsiasi file Markdown:

markdown sicurezza selettore

Il Markdown anteprima le impostazioni di sicurezza si applicano a tutti i file nell’area di lavoro.

Ecco i dettagli su ciascuno di questi livelli di sicurezza:

Strict

Questa è l’impostazione predefinita. Carica solo contenuti attendibili e disabilita l’esecuzione dello script. Blocchi http immagini.

Si consiglia vivamente di mantenere abilitata la protezioneStrict a meno che non si abbia una buona ragione per cambiarla E si consideri attendibile tutti i file markdown nell’area di lavoro.

Consenti contenuti non sicuri

Mantiene gli script disabilitati ma consente di caricare i contenuti suhttp.

Disattiva

Disabilita la sicurezza aggiuntiva nella finestra di anteprima. Ciò consente l’esecuzione di script e consente anche di caricare il contenuto su http.

Snippet per Markdown

Ci sono diversi frammenti di Markdown incorporati inclusi in VS Code-press Space Space (Windows, Linux Ctrl+Space) (Trigger Suggest) e si ottiene un elenco di suggerimenti specifico del contesto.

Suggerimento: È possibile aggiungere i propri frammenti definiti dall’utente per Markdown. Date un’occhiata a frammenti definiti dall’utente per scoprire come.

Compilare Markdown in HTML

VS Code si integra con i compilatori Markdown attraverso il task runner integrato. Possiamo usare questo per compilare.md file in.html file. Camminiamo attraverso la compilazione di un semplice documento Markdown.

Passo 1: Installare un compilatore Markdown

Per questa procedura dettagliata, usiamo il nodo popolare.modulo js, markdown-it.

npm install -g markdown-it 

Nota: Ci sono molti compilatori Markdown tra cui scegliere oltre markdown-it. Scegli quello che meglio si adatta alle tue esigenze e all’ambiente.

Passo 2: Creare un semplice file MD

Aprire il codice VS su una cartella vuota e creare un file sample.md.

Nota: È possibile aprire una cartella con codice VS selezionando la cartella con File> Apri cartella o navigando nella cartella e digitando ‘ codice . alla riga di comando.

Inserire il seguente codice sorgente in quel file:

# Hello Markdown in VS Code!This is a simple introduction to compiling Markdown in VS Code.Things you'll need:* (https://nodejs.org)* (https://www.npmjs.com/package/markdown-it)* (/docs/editor/tasks)## Section Title> This block quote is here for your information. 

Passaggio 3: Creazione di attività.json

Il passo successivo è impostare il file di configurazione dell’attivitàtasks.json. Per fare ciò, eseguire Terminal > Configura attività e fare clic su Crea attività.file json da modelli. VS Code presenta quindi un elenco di possibili modellitasks.json tra cui scegliere. Seleziona Altri poiché vogliamo eseguire un comando esterno.

Questo genera un filetasks.json nell’area di lavoro .vscode con il seguente contenuto:

{ // See https://go.microsoft.com/fwlink/?LinkId=733558 // for the documentation about the tasks.json format "version": "2.0.0", "tasks": }

Per utilizzare markdown-per compilare il file Markdown, modificare il contenuto come segue:

{ // See https://go.microsoft.com/fwlink/?LinkId=733558 // for the documentation about the tasks.json format "version": "2.0.0", "tasks": }

Suggerimento: Mentre il campione è lì per aiutare con le impostazioni di configurazione comuni, IntelliSense è disponibile per l’ tasks.json file per aiutarvi a lungo. Usa Space Space (Windows, Linux Ctrl + Space) per vedere le impostazioni disponibili.

Passo 4: Esegui l’attività di compilazione

Poiché in ambienti più complessi possono esserci più di un’attività di compilazione, ti chiediamo di scegliere l’attività da eseguire dopo aver premuto B B (Windows, Linux Ctrl+Shift+B) (Esegui l’attività di compilazione). Inoltre, ti permettiamo di scansionare l’output per problemi di compilazione. Poiché vogliamo solo convertire il file Markdown in HTML, selezionare Non eseguire mai la scansione dell’output di build dall’elenco presentato.

A questo punto, dovresti vedere un file aggiuntivo visualizzato nell’elenco dei file sample.html.

Se si desidera rendere l’attività Compile Markdown l’attività di compilazione predefinita da eseguire, eseguire Configure Default Build Task dal menu del terminale globale e selezionare Compile Markdown dall’elenco presentato. Il file finale tasks.json sarà quindi simile a questo:

{ // See https://go.microsoft.com/fwlink/?LinkId=733558 // for the documentation about the tasks.json format "version": "2.0.0", "tasks": , "group": { "kind": "build", "isDefault": true } } ]}

Automatizzare la compilazione di Markdown

Prendiamo le cose un po ‘ oltre e automatizziamo la compilazione di Markdown con il codice VS. Possiamo farlo con la stessa integrazione task runner come prima, ma con alcune modifiche.

Punto 1: Installa Gulp e alcuni plug-in

Usiamo Gulp per creare un’attività che automatizza la compilazione di Markdown. Usiamo anche il plug-in gulp-markdown per rendere le cose un po ‘ più facili.

Dobbiamo installare gulp sia globalmente (-g switch) che localmente:

npm install -g gulpnpm install gulp gulp-markdown-it

Nota: gulp-markdown-it è un plug-in Gulp per il modulo markdown-it che stavamo usando prima. Ci sono molti altri plug-in Gulp Markdown è possibile utilizzare, così come i plug-in per Grunt.

È possibile verificare che l’installazione di gulp abbia avuto successo digitandogulp -v. Dovresti vedere una versione visualizzata sia per le installazioni globali (CLI) che locali.

Passaggio 2: Creare un’attività Gulp semplice

Aprire il codice VS sulla stessa cartella precedente (contiene sample.md e tasks.json sotto la cartella .vscode) e creare gulpfile.js alla radice.

Inserire il seguente codice sorgente in quel file:

var gulp = require('gulp');var markdown = require('gulp-markdown-it');gulp.task('markdown', function() { return gulp .src('**/*.md') .pipe(markdown()) .pipe( gulp.dest(function(f) { return f.base; }) );});gulp.task('default', function() { return gulp.watch('**/*.md', gulp.series());}); 

Cosa sta succedendo qui?

  1. Stiamo osservando le modifiche a qualsiasi file Markdown nel nostro spazio di lavoro, ovvero la cartella corrente aperta nel codice VS.
  2. Prendiamo il set di file Markdown che sono stati modificati e li eseguiamo attraverso il nostro compilatore Markdown, cioègulp-markdown-it.
  3. Ora abbiamo un set di file HTML, ciascuno chiamato rispettivamente dopo il loro file Markdown originale. Abbiamo quindi messo questi file nella stessa directory.

Fase 3: Esegui l’attività predefinita gulp

Per completare l’integrazione delle attività con il codice VS, dovremo modificare la configurazione dell’attività da prima di eseguire l’attività Gulp predefinita che abbiamo appena creato. È possibile eliminare il filetasks.json o svuotarlo mantenendo solo la proprietà"version": "2.0.0". Ora esegui Esegui attività dal menu del terminale globale. Osserva che ti viene presentato un selettore che elenca le attività definite nel file gulp. Selezionare gulp: default per avviare l’attività. Ti permettiamo di scansionare l’output per problemi di compilazione. Poiché vogliamo solo convertire il file Markdown in HTML, selezionare Non eseguire mai la scansione dell’output di build dall’elenco presentato. A questo punto, se crei e/o modifichi altri file Markdown, vedrai i rispettivi file HTML generati e / o le modifiche riflesse sul salvataggio. Puoi anche abilitare il salvataggio automatico per rendere le cose ancora più snelle.

Se si desidera eseguire l’attività gulp: default l’attività di compilazione predefinita eseguita premendo B B (Windows, Linux Ctrl+Shift+B) eseguire Configure Default Build Task dal menu del terminale globale e selezionare gulp: default dall’elenco presentato. Il file finale tasks.json sarà quindi simile a questo:

{ // See https://go.microsoft.com/fwlink/?LinkId=733558 // for the documentation about the tasks.json format "version": "2.0.0", "tasks": , "group": { "kind": "build", "isDefault": true } } ]}

Passo 4: Terminare l’attività predefinita gulp

L’attività predefinita gulp viene eseguita in background e controlla le modifiche ai file di Markdown. Se si desidera interrompere l’attività, è possibile utilizzare l’attività Termina dal menu Terminale globale.

Continua a leggere per scoprire:

  • CSS, SCSS e Less – Vuoi modificare il tuo CSS? VS Code ha un ottimo supporto per CSS, SCSS e meno editing.

Domande comuni

C’è un controllo ortografico?

Non installato con codice VS ma ci sono estensioni di controllo ortografico. Controlla il Marketplace VS Code per cercare estensioni utili per aiutare con il tuo flusso di lavoro.

Il codice VS supporta il markdown aromatizzato GitHub?

No, il codice VS si rivolge alla specifica CommonMark Markdown utilizzando la libreria markdown-it. GitHub si sta muovendo verso la specifica CommonMark che puoi leggere in questo aggiornamento.

Nella procedura dettagliata sopra, non ho trovato il comando Configura attività nella tavolozza dei comandi?

Potresti aver aperto un file in codice VS piuttosto che in una cartella. È possibile aprire una cartella selezionando la cartella con File > Apri cartella o navigando nella cartella e digitando ‘ codice . alla riga di comando.



Lascia un commento

Il tuo indirizzo email non sarà pubblicato.