OS4 DepotLogo by Alkaron 
(anonymous IP: 3.239.109.55,0) 
 HomeRecentStatsSearchMirrorsContactInfoDisclaimerConfigAdmin
 Menu

 Features
   Crashlogs
   Bug tracker
   Locale browser
 
 Categories

   o Audio (331)
   o Datatype (50)
   o Demo (188)
   o Development (562)
   o Document (21)
   o Driver (93)
   o Emulation (143)
   o Game (910)
   o Graphics (477)
   o Library (105)
   o Network (218)
   o Office (60)
   o Utility (853)
   o Video (65)

Total files: 4076

Full index file. Download
Recent index file. Download




 Links

  Amigans.net
  OpenAmiga
  Aminet
  UtilityBase
  IntuitionBase
  AmigaBounty


Support the site


 Readme for:  Utility » Text » ami-markdown.lha

AmiMarkdown

Description: Edit and view Markdown documents
Download: ami-markdown.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size: 1Mb
Version: 0.8
Date: 11 Jan 21
Author: Simon Tyrrell, Martin Mitas
Submitter: Simon Tyrrell
Email: tyrrell simon/gmail com
Requirements: dev/mui/MCC_HTMLview, dev/mui/MCC_TextEditor
Category: utility/text
Replaces: utility/text/ami-markdown.lha
License: Other
Distribute: yes
Min OS Version: 4.1
FileID: 11544
 
Images:
 
Videos:
Comments: 1
Snapshots: 0
Videos: 0
Downloads:  (Current version)

[Show comments] [Show snapshots] [Show videos] [Show content] [Show crashlogs] 
This is a tool to allow you to edit and view Markdown documents.  It uses a
customised version of 
md4c at https://github.com/mity/md4c by Martin Mit available to do the actual
conversion of 
Markdown to HTML.

## USAGE:

The window consists of two pages; an Editor page and a Settings page.

### Editor:

The Editor page consists of a tool bar and a text editor gadget which is where
the Markdown source
code will be shown. The text editor is a subclass of the [text editor custom
class](https://github.com/amiga-mui/texteditor) so all of its key shortcuts are
available too.

#### Toolbar

 * **Load**: Load a Markdown file. Alternatively you can either drag and drop a
markdown file onto the window.
 * **Save**: Save the contents of the text editor to a file.
 * **Convert**: Convert to HTML and view in a browser. This will save a new file
with ".html" appended to the name of the markdown file and open it in a browser.
 * **Undo**: Undo the latest changes.
 * **Redo**: Redo the latest reverted changes.
 * **Bold**: Make the selected text bold.
 * **Italic**: Make the selected text italic.
 * **Strikethrough**: Strike through the selected text.
 * **Code**: Make the selected text code.
 * **Horizontal Rule**: Insert a Horizontal Rule.
 * **Fenced Code**: Make a fenced code block.
 * **Hyperlink**: Insert a hyperlink. This will open a new window where you can
enter the link text and address. 
 * **Image**: Insert an image. This will open a new window where you can enter
the image path, its alternative text and an optional title. 
 * **Table**: Insert a table. This will open a new window where you can enter
the number of rows and columns that you require. Also there is an *Alignments*
string gadget where you can specify the alignment for each column. 
By default, each column is left-aligned, however you can alter that here. The
string here will be read where the first character defines the alignment for the
first column, the second character for the second column, *etc.* 
    * *l* will make the column left-aligned, 
    * *r* will make the column right-aligned
    * *c* will make the column centre-aligned.

If the *Alignments* is empty or has fewer characters than the number of
specified columns, the remaining columns will default to being left-aligned. For
example *crlc* would specify that the first four columns of the table would be
centre-, right-, left- and centre-aligned respectively.
 
### Settings:

On this page you can configure some of the options for converting the md4c
Markdown to HTML. For more information on these, view the [md4c
documentation](https://github.com/mity/md4c) 

## FUTURE:

 * Getting the buttons to become selected for given bits of text, e.g. the bold
button being highlighted when the cursor is in a piece of bold text, etc. 
 * Syntax highlighting would be nice too. 
 * Adding more elements to the md4c Markdown to HTML conversion code such as
definition lists, footnotes, *etc.* This would then get added to md4c via pull
requests.
 * The ability to save and load customised conversion settings.
 * Get the *Convert* function to re-use an existing browser window rather than
launch a new one each time.

Any other ideas are welcome. :-)

## CHANGELOG

### 0.8 - (10/01/2021)
 * Moved to using TheBar to give a graphical toolbar along with many more
functions.
 * Added Undo, Redo, Strikethrough, Code, Fenced Code Blocks, Horizontal Rule,
Table, Image and Link functions
	
### 0.5 - (07/01/2021):
 * Changed from using HTMLview to using Launch-Handler which comes with OS4.
 * Added the settings page to allow configuration of the Markdown to HTML
conversion settings. 
 * Added a (very!) :-)) rudimentary set of buttons on the toolbar to allow the
setting of bold, italic and code sections. 
 * Added a test Markdown file.
 * Bug fixes.

### 0.1 - (05/01/2021):
 * Initial release

## LICENSE:

The code is available under the MIT license. The md4c parts are copyright Martin
Mit and the rest 
is copyright (c) 2021  by Simon Tyrrell. The emoticon_bigsmile image is
copyright to Martin Merz, 
go to http://www.masonicons.info for more information and to get his awesome
artwork.


 



Copyright (c) 2004-2021 by Björn Hagström All Rights Reserved
Amiga OS and its logos are registered trademarks of Hyperion Entertainment