File: README.txt

package info (click to toggle)
python-markdown 1.7-1
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 148 kB
  • ctags: 271
  • sloc: python: 1,353; makefile: 9
file content (98 lines) | stat: -rw-r--r-- 3,159 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
[Python-Markdown][]
===================

This is a Python implementation of John Gruber's [Markdown][]. 
It is almost completely compliant with the reference implementation,
though there are a few known issues. See [Features][] for information 
on what exactly is supported and what is not. Additional features are 
supported by the [Available Extensions][].

[Python-Markdown]: http://freewisdom.org/projects/python-markdown
[Markdown]: http://daringfireball.net/projects/markdown/
[Features]: http://www.freewisdom.org/projects/python-markdown/Features
[Available Extensions]: http://www.freewisdom.org/projects/python-markdown/Available_Extensions


Installation
------------

To install Python Markdown [download][] the zip file and extract the 
files.  If you want to install markdown as a module into your python 
tree, run `sudo python setup.py install` from a directory where you 
unzip the files.

[download]: http://sourceforge.net/project/showfiles.php?group_id=153041


Command Line Usage
------------------

To use markdown.py from the command line, run it as 

    python markdown.py <input_file>

or 

    python markdown.py <input_file> > <output_file>

For more details, use the `-h` or `--help` options from the command line 
or read the [Command Line Docs][] available online.

[Command Line Docs]: http://www.freewisdom.org/projects/python-markdown/Command_Line



Using as a Python Module
------------------------

To use markdown as a module:

    import markdown
    html = markdown.markdown(your_text_string)

For more details see the [Module Docs][].

[Module Docs]: http://www.freewisdom.org/projects/python-markdown/Using_as_a_Module

Support
-------

You may ask for help and discuss various other issues on the [mailing list][] and report bugs on the [bug tracker][].

[mailing list]: http://lists.sourceforge.net/lists/listinfo/python-markdown-discuss
[bug tracker]: http://sourceforge.net/tracker/?func=add&group_id=153041&atid=790198


Credits
-------

* Most of the code currently in the module was written by [Yuri Takhteyev][]
  while procrastinating from his Ph.D.
* The original version of this script was written by [Manfred Stienstra][],
  who is responsible for about a quarter of the code.
* Many recent bugs are being fixed by [Waylan Limberg][].

Other contributions:

* Daniel Krech provided the setup.py script.
* G. Clark Haynes submitted a patch for indented lists.
* Tiago Cogumbreiro submitted an email autolink fix.
* Sergej Chodarev submitted a patch for treatment of `<hr/>` tags.
* Chris Clark submitted a patch to handle `<mailto:...>` syntax and a reg ex 
  for "smart" emphasis (ignoring underscores within a word).
* Steward Midwinter wrote command-line parser and cleaned up comments.
* Many other people helped by reporting bugs.

[Yuri Takhteyev]: http://www.freewisdom.org
[Manfred Stienstra]: http://www.dwerg.net/
[Waylan Limberg]: http://achinghead.com/


License
-------

The code is dual-licensed under [GPL][] and [BSD License][].  Other
licensing arrangements can be discussed.

[GPL]: http://www.gnu.org/copyleft/gpl.html) 
[BSD License]: http://www.opensource.org/licenses/bsd-license.php