Skriv för webben med Markdown och formattera till HTML med PHP (v2)

Markdown är ett ofta använt sätt för att låta en användare skriva texter som är läsbara i råformat men enkelt kan formatteras till HTML.

Syntaxen för Markdown och dess första konverteringsverktyg (perl) togs fram av John Gruber som också beskriver syntaxen på ursprungssidan för Markdown. Målet var att få texten så läsbar som möjligt i sitt orginalformat.

En av de “Markdown till HTML formatterare” som finns är Michel Fortin’s PHP Markdown. Michel har även skrivit en modul SmartyPants för hantering av typografiska element.

Du kan installera PHP Markdown via composer.

$ composer require michelf/php-markdown

Du kan nu lägga till en egen funktion för att formattera din text till Markdown, som jag gör här i form av en vanlig funktion.

use \Michelf\Markdown;

/**
 * Helper, Markdown formatting converting to HTML.
 *
 * @param string text The text to be converted.
 *
 * @return string the formatted text.
 */
function markdown($text)
{
    return Markdown::defaultTransform($text);
}

Om du vill testa så har jag en text i Markdown som du kan låna.

Det finns egentligen ett helt exempel som du kan testa i kursrepot för oophp under example/textfilter. Du behöver göra en composer install och sedan kan du öppna din webbläsare mot filen htdocs/markdown.php.

Resultatet kan se ut så här.

Nu kan du börja skriva dina texter för webben enligt Markdown syntax. Det blir text som är lätt att läsa i sitt orginalformat, smidig att skriva och skapar bra HTML. Du kan fortsätta skriva HTML-element inuti din Markdown-text om du behöver mer avancerade konstruktioner som inte stöds i Markdown.

Det finns en tråd i forumet där du kan ställa frågor eller bidra med tips och trix rörande tipset.

#Revision history