a minimal markup language based on godoc

Eli Cox ea907c4ea2 Add css files. 6 years ago
css ea907c4ea2 Add css files. 6 years ago
LICENSE e486778724 It works. 6 years ago
README ea907c4ea2 Add css files. 6 years ago
markgone.go ea907c4ea2 Add css files. 6 years ago
markgone_test.go e486778724 It works. 6 years ago

README

MarkGone a minimal markup language based on godoc

MarkGone uses the minimal formatting syntax from godoc.
Unlike godoc, MarkGone processes plain text, not comments in go source code;


Philosophy

Markups are gone.
In other words, MarkGone text just looks like plain text.


Formatting Syntax

A heading is a single line
followed by another paragraph,
beginning with a capital letter,
and containing no punctuation.

Paragraphs are separated by one or more blank lines.

To produce a pre-formatted blocks,
simply indent every line of the block.
Common indent prefix will be removed in output.

http://example.com/urls_are_auto-linked


Source Code HighLight

MarkGone does not highlight pre-formatted blocks.
The highlighting can be done via JavaScript.
For example, with highlight.js:






CSS

Since markgone only uses four HTML elements

h2, h3, p, pre

customizing css style for it is simple.

Sample css files are provided in the css directory of source code repository:

[]struct{
filename string;
description string;
}{
{"godoc.css":
"mimic godoc style"},
{"plain/blue-link":
"mimic plain text with colored links"},
{"plain/underline-link":
"mimic plain text with underlined links"},
{"plain/white-on-black":
"mimic a console"},
{"plain/green-on-black":
"mimic a console with green text"},
}


Extensions

If the first line is a single line, i.e. followed by a blank line,
then MarkGone uses it as the title.

Tags: space-separated tags on last line following at least one blank-line