markdown

Материал из Xgu.ru

markdown — простой язык разметки, который может использоваться для текстов и документов, которые позже должны быть представлены в виде HTML (или других форматов). Существует поддержка markdown в различных языках программирования, в том числе в Python. На markdown книгу не напишешь, но для простых пометок или для комментариев на форумах он вполне может использоваться.

[править] Пример

$ cat md.txt 
Проверка возможностей разметки markdown.

Список:

* Элемент1
* Элемент2
* Элемент3
* Элемент4

Кусок кода:

    for i in a b c d
    do
      echo $i
    done

Ещё кусок кода:

~~~
while read a
do
  echo $a
done
~~~


$ markdown_py -x extra md.txt -f md.html -e utf-8


$ cat md.html
<p>Проверка возможностей разметки markdown.</p>
<p>Список:</p>
<ul>
<li>Элемент1</li>
<li>Элемент2</li>
<li>Элемент3</li>
<li>Элемент4</li>
</ul>
<p>Кусок кода:</p>
<pre><code>for i in a b c d
do
  echo $i
done
</code></pr e>
<p>Ещё кусок кода:</p>
<pre><code>while read a
do
  echo $a
done
</code></pr e>

[править] Дополнительная информация

• Markdown Syntax (англ.)
• GitHub Flavored Markdown (англ.) — отличия GitHub'овского Markdown от обычного
• Markdown на StackOverflow (англ.) — ничем не отличается особо от стандартного
• PageDown (англ.) — JavaScript-конвертер для Markdown
• Stackedit.io (англ.) — WYSIWYG-редактор markdown