[[oktatas:web:markdown|< Markdown]]

====== Markdown ======

  * **Szerző:** Sallai András
  * Copyright (c) Sallai András, 2015, 2016, 2022, 2023
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC Attribution-Share Alike 4.0 International]]
  * Web: https://szit.hu

===== Bevezetés =====

A Markdown egy speciális dokumentumleíró nyelv, amellyel 
HTML oldalak szerkezetét írhatjuk le HTML nélkül.

A Markdown tartalmazó fájlokat .md kiterjesztéssel használjuk. 

===== Fejezet címek =====

<code>
#első fejezetcím
##második fejezetmcím
###harmadik fejezetcím
####negyedik fejezetcím
#####ötödik fejezetcím
######hatodik fejezetcím
</code>

===== Bekezdés =====

A bekezdéshez legalább egy üres sort tegyünk a szövegbe.

<code>
Első bekezdés.

Második bekezdés.

Harmadik bekezdés.
</code>
===== Dőlt és félkövér =====

<code>

_dőlt_

**félkövér**
</code>

Egész mondatokat vagy mondatrészekkel is dolgozhatunk.

<code>
_egy mondatrész_

**egy másik mondatrész**
</code>


A kettőt keverhetjük:
<code>
**_vegyes stílus_**
</code>

Félkövér vagy dőlt, lehet a fejezetcím is:
<code>
# **Első szintű fejezetcím**
</code>

===== Lista =====

szimpla lista
<code>
* alma
* körte
* barack
* szilva
</code>

számozott lista:
<code>
1. alma
2. körte
3. barack
4. szilva
</code>

kevert:
<code>
1. gyümölcs
    * alma
    * körte
    * szilva
    * barack
2. zöldség
    * sárgarépa
    * fehérrépa
    * karalábé
    * uborka
</code>

===== Hivatkozás =====

<code>
[SzitWiki](http://szit.hu)
</code>

A zárójeles rész nem lehet külön sorban.
===== Behúzás =====

<code>
> Egyszeresen behúzott szöveg
>> Kétszeresen behúzott szöveg
</code>



<code>
> Ha van egy nagyon hosszú, 
több soron átnyúló szövegünk, 
amelyen markdown segítségével 
behúzást szeretnénk alkalmazni, 
kérdéses, hogy minden sorba 
tegyünk-e nagyobb-mint jelet. 

A választ természetesen nem. 
Csak a bekezdés elejére tegyünk.
Ebben a példában a második bekezdés
már nem kerül behúzásra, de az első
minden sora behúzással jelenik meg.
</code>

===== Konverter =====

Debian alapú Linuxokon telepíthető egy markdown program, amely
egy ugyanilyen nevű parancsot eredményez:

  # apt-get install markdown

Egy markdown fájl konvertálása:

  $ markdown fajlnev.md


Készítsük el a példa kedvéért a következő állományt:

<code markdown valami.md>
# Első
## Második

[Zöld weblap](zold.and)

* egy
* kettő
* három
* négy
* öt
</code>


A kimenet ezek után:
<code html>
<h1>Első</h1>

<h2>Második</h2>

<p><a href="zold.and">Zöld weblap</a></p>

<ul>
<li>egy</li>
<li>kettő</li>
<li>három</li>
<li>négy</li>
<li>öt</li>
</ul>
</code>
===== Függelék =====

==== impress.js bemutató ====

Az mdpress csomag (és parancs) segítségével Impress.js 
bemutató generálható markdown állományból.

Szükség van egy gem csomagkezelőre:
  apt install ruby-rubygems  # ez feltesz egy gem parancsot
  apt install ruby-dev       # ez felteszi a fejlesztőeszközt
Utána ezt is rendszergazdaként:
  gem install mdpress


Webhelyek:
  * https://github.com/egonSchiele/mdpress
  * https://mdpress.docschina.org/
  * https://github.com/docschina/mdpress

==== mdpress generátor ====

  npm install generator-mdpress

==== ghostwriter ====

Markdown szerkesztő:

  * https://kde.github.io/ghostwriter/

Telepítés Debian GNU/Linuxon:
  apt install ghostwriter

Lásd: retext

===== Linkek =====

  * http://markdowntutorial.com/
  * https://www.markdownguide.org/basic-syntax/ (2022)
  * https://www.markdownguide.org/extended-syntax/ (2022)
  * https://thegige.wordpress.com/2014/11/19/markdown-utmutato/
  * http://szifon.com/2014/03/22/markdown-cikkek-html-ben-egyszeruen/
  * http://r-projekt.hu/markdown/
  * https://guides.github.com/features/mastering-markdown/
  * https://help.github.com/articles/markdown-basics/
  * https://help.github.com/articles/github-flavored-markdown/
  * http://daringfireball.net/projects/markdown/
  * https://github.com/jiho/Markdown2pdf (mardown2pdf)
  * https://www.npmjs.com/package/markdown2pdf (markdown2pdf)
  * https://guides.github.com/features/mastering-markdown/ (2020)