Вот простейший способ просматривать документы в разметке Markdown на своем сайте:
в .htaccess добавляем строки
Action markdown /markdown/handler.php
AddHandler markdown .md .markdown
создаем каталог markdown и помещаем туда handler.php
<?php
header('Content-type: text/html; charset=utf-8');
?>
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" type="text/css" href="/markdown/style.css">
<meta name="content-type" http-equiv="content-type" value="text/html; utf-8">
</head>
<body>
<?php
require('markdown.php');
$legalExtensions = array('md', 'markdown');
$file = str_replace('\\', '/', realpath($_SERVER['PATH_TRANSLATED']));
if($file
&& in_array(strtolower(substr($file,strrpos($file,'.')+1)), $legalExtensions)
&& substr($file,0,strlen($_SERVER['DOCUMENT_ROOT'])) == $_SERVER['DOCUMENT_ROOT']) {
echo Markdown(file_get_contents($file));
} else {
echo "<p>Bad filename given</p>";
}
?>
</body>
</html>
Рядом кладем парсер PHP Markdown
а стилевой файл, какой захотите.
Теперь при обращении к любому файлу на сайте с расширением .md или .markdown будет показываться нормальная страница с полноценной разметкой.
Рецепт взят отсюда: sminnee's markdown-handler, я только добавил str_replace чтобы на Windows тоже работало