Snížení

Aktuální verze stránky ještě nebyla zkontrolována zkušenými přispěvateli a může se výrazně lišit od verze recenzované 22. června 2022; kontroly vyžadují 6 úprav .
Snížení
Rozšíření .md,
.markdown[1]
MIME typ text/markdown [5]
Vývojář John Gruber
zveřejněno 19. března 2004 [2] [3] ( 2004-03-19 )
Poslední vydání 17. prosince 2004  ( 2004-12-17 )
Typ formátu Značkovací jazyk
otevřený formát ? ano [4]
webová stránka daringfireball.net/proje…
 Mediální soubory na Wikimedia Commons

Markdown ( MPA : [ ˈ m ɑ ː k d a ʊ n ], vyslovováno markdown ) je lehký značkovací jazyk navržený k označení formátování v prostém textu , při zachování jeho lidské čitelnosti v maximální možné míře a vhodný pro strojový převod do jazyků pro pokročilé publikace ( HTML , Rich Text a další).

Historie

Původně vytvořili v roce 2004 John Gruber a Aaron Schwartz . Mnoho jazykových nápadů bylo vypůjčeno z existujících konvencí pro označování textu v e-mailech . Implementace jazyka Markdown převádějí text Markdown do platného , ​​dobře tvarovaného XHTML a nahrazují levé lomené závorky ("<") a ampersandy ("&") příslušnými kódy entit. První implementací Markdownu byla Gruberova implementace Perl , ale postupem času se objevilo mnoho implementací třetích stran (viz níže ). Implementace Perl je distribuována pod licencí typu BSD . Implementace Markdown v různých programovacích jazycích jsou zahrnuty (nebo dostupné jako plugin ) v mnoha systémech pro správu obsahu .

Příklady syntaxe

Následují příklady použití Markdown, ale v žádném případě to není úplný průvodce. Úplný popis jazyka lze nalézt na oficiálních stránkách [6] . Postavy, se kterými se v Markdown normálně zachází jako se speciálními, mohou být escapovány zpětným lomítkem . Například sekvence "\*" zobrazí znak "*" a nebude znakem začátku vybraného textu. Markdown také nepřevádí text uvnitř „surových“ bloků XHTML. Sekce XHTML tak mohou být zahrnuty do dokumentu Markdown tak, že je nejprve zabalíte do značek na úrovni bloku.

Text s důrazem nebo logickým důrazem

*zvýraznění* (např. kurzíva) **silné zvýraznění** (např. tučné)

Kód programu

Prvky kódu mohou být uvnitř řádkových (inline) nebo víceřádkových bloků.

Uvnitř řetězce je kód zvýrazněn znakem "`" ( backtick ).

Příklad kódu uvnitř řádku (inline) „Ahoj světe!“

Víceřádkový blok kódu je označen odsazením 4 mezer nebo jedním tabulátorem .

Níže začíná víceřádkový blok kódu <!doctypehtml> <html> <hlava> <!-- Název dokumentu --> </head> <body> <!-- Tělo dokumentu --> </body> </html> Blok kódu skončil

Přeškrtnutý text

musíte udělat ~~jednu věc~~ jinou věc

Seznamy

* prvek seznamu s odrážkami - další prvek neuspořádaného seznamu + odrážky prvků mohou být různé 1. Číslo položky seznamu 2. Číslo položky 2 stejného seznamu 9. Položka číslo 3 seznamu - prvky jsou číslovány v pořadí, na čísle na začátku řádku nezáleží

Tituly

Nadpisy se vytvářejí umístěním znaku libry před text nadpisu. Počet znaků "#" odpovídá úrovni nadpisu. HTML poskytuje 6 úrovní nadpisů.

# Nadpis první úrovně ... ### Nadpis třetí úrovně ... ###### Nadpis 6. úrovně

První dvě úrovně nadpisů mají také alternativní syntaxi:

Nadpis první úrovně ========================= Nadpis druhé úrovně -------------------------

Citáty (tag blockquote)

> Tento text bude zabalen do HTML značek <blockquote></blockquote>

Odkazy

[ Text odkazu ]( http://example.com/ "Volitelný název odkazu" )

alternativní způsob nastavení odkazů, pokud se opakují

Někde v textu je [ text odkazu ][ příklad ]. Odkaz se také opakuje [ příklad adresy ][ příklad ]. Odkaz na [ second ][ foo ] také [ Bar ][] zdroje. [ příklad ]: http://example.com/ "Volitelný název odkazu" [ foo ]: http://example.net/ 'Volitelný název odkazu' [ pruh ]: http://example.edu/ (Volitelný název odkazu )

Obrázky

![ Alt text ]( http://example.com/ "Název obrázku" )

Implementace Markdown

Rozšíření

Následující aplikace implementují Markdown a rozšiřují jeho syntaxi o další funkce:

  • MultiMarkdown (C) [32]
  • Text::MultiMarkdown (Perl) modul, který implementuje rozšíření MultiMarkdown [33]
  • PHP Markdown Extra [34]
  • python-markdown2 (Podporuje některá rozšíření PHP Markdown) [27]
  • python-markdown (Má systém rozšíření pro přidání nové syntaxe) [26]
  • Markout (Java) [35]
  • Pegdown (Java) [18]
  • Maruku (rubín) [29]
  • Pandoc (Haskell) [16] [36]

Vodítka

  • Online převodník Markdown: Dingus [37]
  • Markdown cheat sheet [38]

Převodníky

  • od HTML po Markdown
    • html2text.py (napsaný v Pythonu ) [39]
    • Markdownify (v PHP ) [40]
    • Make.text je bookmarklet , který převede jakoukoli webovou stránku na Markdown [41]
    • XHTML-to-Markdown XSLT (šablona stylů XSLT, funguje pouze s XHTML) [42]
    • Pandoc  je knihovna pro konverzi formátu Haskell , která podporuje několik dialektů Markdown ( markdown - dialekt pandoc, markdown_strict původní Markdown bez přípon,  dialekt PHP , markdown_phpextra dialekt github ) lze převádět z a do Markdown, HTML , reStructuredText , LaTeX a další. [16]markdown_github
  • Další formáty v Markdown

Utility

  • Nástroj Markdown ( Python skript pro načítání dokumentů Markdown spolu s obrázky) [45]
  • Writage je plugin pro Microsoft Word, který umožňuje převádět dokumenty DOCX do formátu Markdown a naopak.

Webové aplikace využívající Markdown

  • wiki :
  • Blogy :
    • Tumblr  - zpočátku zakázáno, ale lze jej použít povolením v nastavení.
    • scriptogr.am
  • CMS :
    • Drupal  – filtr obsahu Markdown [46]
    • Magento  - pomocí modulu [47]
    • Plone  – nativní podpora v Plone 3
    • TYPO3  – pomocí pluginu af_markdown [48]
    • RadiantCMS  je jedním z typů značek dostupných ihned po vybalení [49]
    • HTMLy - používá se ve výchozím nastavení pro ukládání obsahu (místo databází) [50]
  • Webové rámce :
    • Ruby on Rails  – vyžaduje instalaci BlueCloth, Maruku [51]
    • Yii  - widget CMarkdown, který je součástí standardní dodávky rámce
    • Webasyst  - součástí standardní dodávky frameworku PHP jako plugin pro bezplatnou aplikaci Blog
    • Symfony  – Vyžaduje instalaci balíčku KnpMarkdownBundle
  • Sociální aplikace:

Podpora textových editorů

Poznámky

  1. ↑ Přípona souboru Markdown  ( 1. srpna 2014). Získáno 16. července 2020. Archivováno z originálu dne 12. července 2020.
  2. ↑ Markdown  . _ Aaron Swartz: Weblog (19. března 2004). Získáno 16. července 2020. Archivováno z originálu dne 25. prosince 2019.
  3. ↑ Daring Fireball: Markdown . Získáno 16. července 2020. Archivováno z originálu dne 15. července 2020.
  4. ↑ Markdown: Licence . Odvážná ohnivá koule. Získáno 16. července 2020. Archivováno z originálu dne 17. června 2020.
  5. ↑ Leonard S. The text/markdown Media Type  (anglicky) - IETF , 2016. - 15 s. doi : 10.17487/RFC7763
  6. ↑ Popis syntaxe Markdown Archivováno 22. února 2011 na Wayback Machine 
  7. ↑ Markdownsharp
  8. ↑ Knagis CommonMark.NET . Získáno 4. července 2018. Archivováno z originálu 11. června 2018.
  9. ↑ Discount – implementace značkovacího jazyka Markdown v jazyce C. Získáno 29. května 2008. Archivováno z originálu 4. června 2008.
  10. ↑ Knihovna pro rychlé a bezpečné zpracování markdown vyhovující standardům v C. Získáno 8. 4. 2015. Archivováno z originálu 1. 8. 2015.
  11. ↑ Implementace markdown v C pomocí gramatiky PEG . Získáno 8. dubna 2015. Archivováno z originálu 23. března 2015.
  12. ↑ Flexibilní knihovna C pro analýzu markdown . Získáno 9. dubna 2015. Archivováno z originálu 20. května 2018.
  13. ↑ CFX_Markdown | Seb Duggan (nedostupný odkaz) . Datum přístupu: 29. května 2008. Archivováno z originálu 23. listopadu 2008. 
  14. ↑ CL-Markdown – Markdown a další . Získáno 29. května 2008. Archivováno z originálu 16. května 2008.
  15. ↑ Blackfriday: markdown procesor pro Go . Získáno 15. října 2013. Archivováno z originálu dne 20. června 2014.
  16. ↑ 1 2 3 Pandoc - O pandoc (stahování) . Datum přístupu: 29. května 2008. Archivováno z originálu 26. srpna 2007. 
  17. ↑ myabc/markdownj . GitHub. Datum přístupu: 28. ledna 2016. Archivováno z originálu 17. února 2016.
  18. ↑ 1 2 dokka--Kotlin Resources . Získáno 29. listopadu 2017. Archivováno z originálu 1. prosince 2017.
  19. ↑ Showdown – JavaScriptový port Markdownu . Získáno 10. srpna 2012. Archivováno z originálu dne 21. srpna 2013.
  20. ↑ intellij-markdown . GitHub. Získáno 29. listopadu 2017. Archivováno z originálu 11. června 2018.
  21. ↑ Dokumentační modul pro Kotlin . Získáno 11. srpna 2010. Archivováno z originálu 22. června 2013.
  22. ↑ NÁZEV . Získáno 29. května 2008. Archivováno z originálu 16. května 2008.
  23. ↑ Vyhledávač, který dělá na InfoWeb.net  (odkaz dolů)
  24. ↑ Text::Markdown - search.cpan.org
  25. ↑ PHP Markdown . Datum přístupu: 29. května 2008. Archivováno z originálu 2. června 2008.
  26. ↑ 1 2 Markdown v Pythonu: Přehled (downlink) . Získáno 29. května 2008. Archivováno z originálu 24. května 2008. 
  27. ↑ 1 2 python-markdown2 - Hosting projektu na Google Code . Staženo 17. 5. 2018. Archivováno z originálu 11. 6. 2018.
  28. ↑ BlueCloth Archivováno 13. června 2008.
  29. ↑ 1 2 Maruku: překladač Markdown-superset (downlink) . Získáno 29. května 2008. Archivováno z originálu 20. června 2008. 
  30. ↑ MarkWrap - Unified Scala wrapper API pro různá odlehčená rozhraní API . Získáno 5. září 2011. Archivováno z originálu 27. srpna 2011.
  31. ↑ Projekt CAIUS má čistý Tcl balíček pro zpracování Markdown
  32. ↑ MultiMarkdown . Získáno 9. září 2012. Archivováno z originálu dne 4. července 2013.
  33. ↑ Text::MultiMarkdown - search.cpan.org
  34. ↑ PHP Markdown Extra . Získáno 29. května 2008. Archivováno z originálu 22. května 2008.
  35. ↑ Markout: Markout (downlink) . Datum přístupu: 29. května 2008. Archivováno z originálu 23. února 2008. 
  36. ↑ Pandoc's markdown versus standardní markdown Archivováno 12. května 2014 na Wayback Machine 
  37. ↑ Daring Fireball: Markdown Web Dingus . Získáno 29. května 2008. Archivováno z originálu 12. června 2008.
  38. ↑ warpedvisions.org :: Markdown cheat sheet . Získáno 13. října 2013. Archivováno z originálu 12. října 2013.
  39. ↑ html2text: ASCIINATOR (aka html2txt) . Získáno 29. května 2008. Archivováno z originálu 9. května 2008.
  40. ↑ Markdownify: Převaděč HTML na Markdown pro PHP (downlink) . Získáno 29. května 2008. Archivováno z originálu 5. června 2008. 
  41. ↑ Make.text
  42. ↑ Elements or Lower :: Geekery : XML : XHTML-to-Markdown.html . Získáno 29. května 2008. Archivováno z originálu 4. června 2008.
  43. ↑ Markdown v Pythonu: odt2txt Archivováno 24. května 2008.
  44. ↑ ProgTips "Blog Archive" Převaděč Word to Markdown (downlink) . Datum přístupu: 29. května 2008. Archivováno z originálu 27. března 2008. 
  45. ↑ Nástroj Markdown . Získáno 11. července 2021. Archivováno z originálu dne 1. dubna 2021.
  46. ↑ Markdown filtr pro Drupal | drupal.org . Získáno 18. listopadu 2010. Archivováno z originálu 25. září 2010.
  47. ↑ Modul "Markdown editor" pro Magento . Získáno 8. listopadu 2015. Archivováno z originálu 4. března 2016.
  48. ↑ typo3.org: Repository (downlink) . Datum přístupu: 29. května 2008. Archivováno z originálu 17. listopadu 2006. 
  49. ↑ RadiantCMS (downlink) . Získáno 2. března 2021. Archivováno z originálu dne 4. června 2006. 
  50. ↑ HTML . Získáno 19. září 2018. Archivováno z originálu 19. září 2018.
  51. ↑ Vyhledávač, který funguje na InfoWeb.net Archivováno 8. září 2008. nebo RDiscount Archived 27. srpna 2010 na Wayback Machine , což je vývoj BlueCloth
  52. ↑ Markdown Vim Mode | plastový kluk . Získáno 24. listopadu 2015. Archivováno z originálu 14. ledna 2016.
  53. ↑ Režim Markdown Emacs . Získáno 24. listopadu 2015. Archivováno z originálu 30. listopadu 2015.
  54. ↑ Ecto, editor blogu Archivováno 18. září 2009 na Wayback Machine 
  55. ↑ Plugin Markdown pro editor prostředí Eclipse Archivováno 31. prosince 2009.  (Angličtina)
  56. ↑ Markdown plugin pro textový editor gedit Archivováno 13. září 2009.  (Angličtina)
  57. ↑ iA Writer pro Mac Archivováno 12. ledna 2012.  (Angličtina)
  58. ↑ iA Writer: Soustřeďte se – aplikace na Google Play. . play.google.com. Datum přístupu: 18. listopadu 2018. Archivováno z originálu 8. dubna 2019.
  59. ↑ Gregor Santner. Markor . — 04.07.2022.
  60. ↑ ReText – textový editor pro Markdown a reStructuredText Archivováno 11. listopadu 2012.  (Angličtina)
  61. ↑ Texty – bohatý editor pro prostý text Archivováno 14. října 2012 na Wayback Machine 
  62. ↑ https://typora.io/ Archivováno 11. března 2020 na Wayback Machine Typora - editor markdown, čtečka markdown.