Grunderna i Markdown

Det här avsnittet täcker den viktigaste Markdown-syntaxen.

Rubriker

Rubriker i Markdown är alla streck som föregås av en **# ** (hash)-symbol. Antalet hash-hash anger rubrikens nivå. Det första innehållet i filen efter metadatablocket måste vara titeln som H1-rubrik (# Header). Alla huvudämnen bör taggas ytterligare som rubriknivå 2 (## Header).

Det finns totalt 6 nivåer som du kan använda - men för de flesta skrivning behöver du sällan mer än 3.

[! NOT]Varje Markdown-fil måste ha en och endast en H1-rubrik.
Det måste finnas ett blanksteg mellan den sista # och rubriktexten.
Rubriknivåerna 4, 5 och 6 visas inte i fästen (höger sida av sidan) och har inga fästpunkter.

Höjdpunkter i texten

Astersisks och understreck används för att formatera text så fet eller kursiv. De är helt utbytbara.
Lorem *markdownum * **propiusque ** _rubet _ __ergo __ quaerere Thebas iuvenes viscera * et _ et ' nec atque vetaris.

Listor

Punktlista:

  • Lista punkt 1
  • Lista objekt 2
    • Listobjekt 2.1
    • Lista punkt 2.2
  • Lista objekt 3

Numrerad lista:

  1. Lista punkt 1
  2. Lista objekt 2
    1. Listobjekt 2.1
    2. Lista punkt 2.2
  3. Lista objekt 3

Tabeller

Det enklaste sättet att skapa en tabell i Markdown är att använda rör och linjer. För ett sidhuvud anger du en streckad linje efter den första raden. Du kan justera kolumnerna med hjälp av kolon.

Rubrik 1 Rubrik 2 Rubrik 3
Vänsterjusterad Centrerat justerat Högerjusterad
... ... ...

Du kan också använda Bord Generator.

Källkod

Automatisk identifiering:

<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="Write"/>
</AppPermissionRequests>

Definiera språk:

private void index(){
  MessageBox.Show("hello world");
}

Utan färg:

private void index(){
  MessageBox.Show("hello world");
}

Blockquotes

Blockquotes skapas med hjälp av >tecknet:

Caespite suo caesa colorem hals. Tamen thalamumque remisit turba. Har dominis fecundo ille, antraque, nec atque vetaris utque, Munychiosque. Saltumque snö mentae, iam umbram latratu. Securus född Hecabe falsum sola non voluit terrier ablata vinclisque pavor Fluctibus.

Varningar

Följande aviseringstyper är tillgängliga:

[! NOT] Caespite suo caesa, antraque, nec atque vetaris utque, Munychiosque. Saltumque snö mentae, iam umbram latratu. Securus född Hecabe falsum sola non voluit terrier ablata vinclisque pavor Fluctibus.

[! TIPS] Caespite suo caesa, antraque, nec atque vetaris utque, Munychiosque. Saltumque snö mentae, iam umbram latratu. Securus född Hecabe falsum sola non voluit terrier ablata vinclisque pavor Fluctibus.

[! VIKTIG] Caespite suo caesa, antraque, nec atque vetaris utque, Munychiosque. Saltumque snö mentae, iam umbram latratu. Securus född Hecabe falsum sola non voluit terrier ablata vinclisque pavor Fluctibus.

[! FÖRSIKTIGHET] Caespite suo caesa, antraque, nec atque vetaris utque, Munychiosque. Saltumque snö mentae, iam umbram latratu. Securus född Hecabe falsum sola non voluit terrier ablata vinclisque pavor Fluctibus.

[! VARNING] Caespite suo caesa, antraque, nec atque vetaris utque, Munychiosque. Saltumque snö mentae, iam umbram latratu. Securus född Hecabe falsum sola non voluit terrier ablata vinclisque pavor Fluctibus.

Länkar

Länkar pekar användare på innehåll på samma sida, på andra närliggande sidor eller på externa webbplatser och webbadresser.

Använd målets relativa position:

  • ./ = aktuell katalog
  • ../ = en katalog ovan
  • ../media/file.demo= en katalog ovan, i * mediemappen, hitta * file.demo **

[! TIPS]Bästa praxis: Alla interna länkar bör börja med ./eller ../.

[! FÖRSIKTIGHET]Undvik att använda:

Media

Om du vill använda bilder lägger du till dem i databasen med hjälp av sökvägsdefinitionen som används för Länkar.

[! TIPS]Bästa praxis: Ladda upp alla bilder i *mediemappen. * Den här mappen är redan en del av Demo-projektet.

Bilder

Följande filtyper stöds för bilder:

  • .jpg
  • .png

[! NOT].bmp grafik fungerar inte i Markdown.

COSMO KONSULTERA

Videor

Undvik att kopiera videor direkt till databasen. Bästa praxis här är att ladda upp videon någon annanstans och länka till videon.

[! Video https://web.microsoftstream.com/embed/video/86bf382e-556e-4100-91f4-e4dda2d53a2a?autoplay=false&showinfo=true]

Användbara tips

HTML

Även om Markdown stöder infogad HTML rekommenderas inte HTML för publicering till dokument, och förutom en begränsad lista med värden kommer det att orsaka byggfel eller varningar.

Syntax för kommentar

Användbart för avsnitt som inte är klara.

<!-- Comments -->

Radbrytningar (mjuk retur)

I redigeraren lägger du till två tomma blanksteg i slutet av meningen och slår retur.

Vinkelparenteser

Om du använder vinkelparenteser i text i filen , till exempel för att beteckna en platshållare, måste du manuellt koda vinkelparenteserna. Annars tror Markdown att de är avsedda att vara en HTML-tagg.

Koda till exempel <script name>som \<script name>.

Vinkelparenteser behöver inte undkommas i text formaterad som infogad kod eller i kodblock.

[! NOT]Om du vill visa ett bokstavligt tecken som annars skulle användas för att formatera text i ett Markdown-dokument lägger du till ett omslagsstreck () framför tecknet.

Apostrofer och citattecken

Om du kopierar från Word till en Markdown-redigerare kan texten innehålla "smarta" (lockiga) apostrofer eller citattecken. Dessa måste kodas eller ändras till grundläggande apostrofer eller citattecken. Annars slutar du med sådana här saker när filen publiceras: Itâ € ™s.