Samstag, 29. Juli 2017

Pri markdaŭno (Markdown)

Pri markdaŭno mi skribis jam en 2014. Intertempe mi skribas ĉiujn manuskriptojn, tradukojn, elektronikajn librojn, blogerojn kaj tiel plu en markdaŭna formato.

Ĉiuj grandaj operaciaj sistemoj kaj multaj programlingvoj havas konvertilojn, per kiuj mi povas ŝanĝi markdaŭnan tekston al HTML- aŭ alia formato (doc, docx, pdf, rtf ka.). Tial markdaŭnaj dosieroj taŭgas por interŝanĝo de tekstoj inter diversaj operaciaj sistemoj.

Se vi volas elprovi markdaŭnon, faru tion en interreto:



Hodiaŭ mi prezentas kelkajn bazajn markaĵojn (etikedojn), kiujn oni povas uzi por markdaŭnaj tekstoj.

Ekzistas pliaj markaĵoj, sed mi ĉefe uzas nur ĉi tiujn, kiujn mi priskribas ĉi-sube.



Titoloj

Titollinioj ricevas kradsignon (dieson) komence de la linio. La nombro de kradsignoj indikas la nivelon de la titollinio.
    
# titollinio 1a-ranga (HTML: H1)

## titollinio 2a-ranga (HTML: H2)

### titollinio 3a-ranga (HTML: H3)


titollinio 1a-ranga

titollinio 2a-ranga

titollinio 3a-ranga



Disigo de alineoj

Blanka (senenhava) linio disigas du alineojn.
...


Elstarigita kaj emfazita tekstoj

**Po du steletoj markas grasan tekston.** (La markaĵoj estas skribita maldekstre kaj dekstre de la teksto!)


Po du steletoj markas grasan tekston.

_Po unu substreko aŭ unu steleto markas emfazitan tekston._ (La markaĵoj estas skribita maldekstre kaj dekstre de la teksto!)


Po unu substreko aŭ unu steleto markas emfazitan tekston.


Listo

* (steleto) signas listeron:

* unua listero
* dua listero


  • unua listero
  • dua listero

Numeritaj listoj

Numeritaj listoj havas numeron kun postmetita punkto komence de la linio. La numeroj ne devas esti sinsekvaj:

1. unua linio
4. dua linio
4. tria linio

La rezulto:

  1. unua linio
  2. dua linio
  3. tria linio

Vertikala linio


Tri steloj en vico kreas horizontalan linion:

***






Difinlistoj

Difinlistoj ne ekzistas en tekstoprogramoj. Mi kelkfoje uzas ilin anstataŭ tabeloj.

Difinlisto difinas nocion kaj
: sub ĝi post po dupunkto priskribojn.
: La nombro de priskriboj ne estas limigita.




Difinlisto difinas nocion kaj
sub ĝi post po dupunkto priskribojn.
La nombro de priskriboj ne estas limigita.



Ligiloj

Interreta ligilo konsistas el priskribanta teksto en angulaj krampoj kaj post ili sen spaceto la adreso (URL) en rondaj krampoj:

[priskribo](www.majkel.de)



Bildoj

Bildo (ligilo de bildo) estas enmetata per voksigno, alternativa teksto en angulaj krampoj kaj post ili sen spaceto la adreso (URL) en rondaj krampoj:

![alternativa teksto](bildo.jpg)


Multi-markdaŭno

Ekzistas diversaj etendaĵoj por la origina markdaŭno. Unu el ili estas multi-markdaŭno (Multimarkdown, MMD). Ĝi aldonas inter alie piednotojn kaj tabelojn.


Piednotoj

Piednotojn[^piednoto-12] oni povas meti ĉien en la teksto. La kolektado de piednotoj en glosaro kaj la numerado okazas aŭtomate. La ligilo al piednoto estas skribata en angulaj krampoj kun cirkumflekso kaj cel-indiko. La piednoto mem estas markata laŭ la sama maniero kun sekvanta dupunkto:

[^piednoto-12]: Tio estas piednoto.

Piednotoj estu skribataj en la teksto inter du alineoj, ne fine de ĝi. Markdaŭno ĉiam metas glosaron post la fino de la teksto, ĉar HTML ne konas klasikajn (libro-)paĝojn.


Tabelo

Oni kreas tabelojn laŭ la jena maniero:


  • Inter la kolonoj de tabelo staras vertikala streko (|).
  • Tabelo havas kapon.
  • Inter kapo kaj enhavo de la tabelo estas apartiga linio.


|unua kolono|dua kolono|tria kolono|
|-|-|-|
|enhavo 1|enhavo 2|enhavo 3|
|enhavo 4|enhavo 5|enhavo 6|

La rezulto:


unua kolonodua kolonotria kolono
enhavo 1enhavo 2enhavo 3
enhavo 4enhavo 5enhavo 6

aŭ kun indiko de ĝisrandigo:


|unua kolono|dua kolono|tria kolono|
|:-|:-:|-:|
|maldekstrema|centrigita|dekstrema|
|enhavo 4|enhavo 5|enhavo 6|

La rezulto:


unua kolonodua kolonotria kolono
maldekstremacentrigitadekstrema
enhavo 4 enhavo 5enhavo 6

En elektronikaj libroj tabeloj havu nur du, en escepta kazo tri kolonojn.

(Fino)