This lightweight syntax is subject to change, perhaps to more fully align it with Markdown
. (Also see Is HTML a Humane Markup Language?
.) Also see a few webmark links on lightweight-syntax-markup
Nest lists by indenting two spaces at a time; different types of lists can be nested inside of each other.
Hyperlinks matching the regular expression below get auto-linked.
Hyperlinks may be included as footnotes:
"reference them like this"
- zero or more whitespace chars between the
] and the start of the protocol
- footnotes declarations must follow the reference(s)
- the earliest matching declaration found below the reference is used
To link from item to item, do
portion is optional, and will display as the anchor text if specified. (Maybe the number-only version gets auto-converted to name/number when the item is saved.) No existence check is made.
can be used at the beginning of a line to wrap it in
Line break magic
If there are 2+ blank lines before/after a bullet or
, one of them is removed (so the plaintext can be separated but the rendered text doesn't look all spaced out).
Monospacing (for code)
; The text within has tabs intelligently turned into <= 4 spaces upon rendering. If any line is longer than 80 characters, the width of the
is explicitly set.
Preceding a line inside
will cause that line to be highlit, excluding leading and trailing whitespace.
`code` renders as
unless the first ` is written as \` (single line only)
, and any other special characters with
prevents them from being parsed.
This is quoted text.
This is quoted text starting with
^[ ]*".+?"[ ]*$ -> <blockquote>
gets rendered with a red bar instead of a gray one — this is good for documenting error messages, like these three
( — ) if outside of
(note the surrounding spaces)
[a-zA-Z]+:// # protocol
(?<p>\() # [track] open parentheses
[\w#~@#$%&\-+=/?.,:;!'*] # valid URL characters (excluding parens)
(?(p) # allow one close paren for each open
(?<-p>\)) # see balanced constructs with .NET Regex
(?<![.,:;!]) # last character cannot be punctuation