To write docs, with emphasis on writability and readability of the text,
but still want to render it into nice HTML, Markdown is the way to go.
However, web browser does NOT render markdown document directly (maybe eventually they will?). As of now, a program take the markdown doc as input and convert it to html.
Markdown syntax provides a concise overview and reference.
To a large extend, markdown convey the spirit of LaTeX, focus on content, let a render engine worry about the pretty facing work. I am not sure how tables are handled, which was the deal breaker for me in LaTeX.
Confluence WiKi Tags
@username # hyperlink to the person being tagged on the page.
[[wiki-page-name]] # hyperlink to another wiki page
block of code # monospaced , preformatted text
don't work in comment section, not sure how P.Killer does it...
Trac WiKi Tags
= heading =
== subheading ==
[[BR]] line break. wiki does not interpret normal CR/LF as new line, it will parse text continuously like html does, it will only break into new paragraph if there is a blank line between two block of text. Kinda anoying :(
List = Use space, asterisk, space, like this:
* list entry 1
* list entry 2
* list entry 2a
- - - - # horizontal line
CamelCaseText # automatically create a new file link w/in WiKi, click to edit.
# CamelCase req start with Uppercase followed immediately by at
# at least one lower case. No dash, symbol, number, only text.
!NotCamelCase # WiKi escape so that it doesn't treat it as a link
pre formatted text goes inside triple braces
http://... # automatic link
http://file.png # automatic inline image into WiKi page
trac = ticket tracking system with build in WiKi
Allows for html code via:
HTML code goes in this area
Docu WiKi Tags
syntax for doku wiki
====== Level 1 Headline ====== (6 equals)
==== Level 3 Headline ==== (4 equals, each level has 1 FEWER equals)
== Level 5 Headline == (2 equals min, less than that will be verbatim)
[[ linktonewdoc ]] (seems to have a directory structure in place, inherit from first doc link was created?)
[[ dir:linktonewdoc ]]
\\ (two backslash + one space) Force new line