Yet another text to HTML processor which was designed for writing small and medium tech documents and notes
Version: 0.8.6Kiwi is yet-another-markup language which is designed to be used for writing your documentation in an text editor such as Vi or Emacs.
Operating System: Mac OS X
Most existing markups are designed to be used as wiki/web markup, with the implication that they do not expect the markup content to use indentation to express structure.
When writing long documents (like tech notes, or manuals) in ASCII format, it is good to use as many visual cues (underlining, indentation) to express the structure of the document. Kiwi is one of the few markup engines that is designed with in this perspective from the ground.
Additionally, Wiki can be used as a wiki/web markup engine, as it is quite close (but not exactly similar) to Markdown
Kiwi comes with a nice command-line interface, can be embedded in applications, and is integrated into Tahcheeand SDoc(which are other Ivy projects).
Rich text markup
Code, sections, references, terms, quotes, images, tables, multi-level lists are a subset of the things you can denote in your document.
Kiwi was designed to be easily embeddable, either trough the command line or through its Python API. The specific thing that makes it better for embedding is that the generated HTML file keeps track of the original markup location in the source file, so that it is easy to update the markup from its HTML representation.
Free HTML and XML code embedding
Whenever you feel more confortable with typing HTML or XML code instead of Kiwi markup, you can switch and put your HTML tags ''as is''. Markdown, for instance, supports that to some extent, where Kiwi gives you much more flexibility.
If you are not satified with the currenlty existing markup, or you'd like to add something of your own, Kiwi can be very easily extended. Its parser is designed to work with plugins, which you can insert at any time.
As an example adding wiki-links markup to Kiwi was done in less than 10 lines of code.