Short:        Markdown datatype: tables, code, images
Author:       Serkan Dursun
Uploader:     Serkan Dursun <blasterreal gmail com>
Type:         util/dtype
Version:      1.0
Requires:     OS 3.2, 68020; text/edit/EmojiGear5.3.lha + TTF fonts advised
Architecture: m68k-amigaos >= 3.2.0
Distribution: Aminet

markdown.datatype shows Markdown documents (.md, .markdown) in MultiView
and in every other program that uses datatypes, the way GitHub or the
preview of VS Code show them - not as plain text with stars and hashes.

Features
- Headings in three sizes, bold, italic, struck out text, inline code,
  keys (<kbd>), horizontal rules, hard line breaks
- Bullet, numbered and task lists, nested in any depth
- Tables with column alignment; cells are wrapped inside their column
- Code blocks in a box with syntax colours (C/C++, Python, JavaScript,
  Java/C#, Rust, Go, shell, SQL, Lua, PHP, 68k assembler) and a "Copy"
  button that puts the code into the clipboard
- Pictures (![alt](file) and <img>), loaded with the system's picture
  datatypes: PNG with alpha, JPEG, IFF and whatever else you have;
  scaled down to the window, optional width, centred with <p align>
- Links: web links open your browser (openurl.library), #heading links
  scroll, links to other files open a new MultiView window
- Block quotes, nested, and GitHub alerts ([!NOTE], [!TIP],
  [!IMPORTANT], [!WARNING], [!CAUTION])
- Entities (&copy; &euro; ...), :emoji: short codes, common HTML tags
  (<b> <i> <a> <img> <br> <kbd> <p align> <div align> <hN>, comments),
  front matter is hidden
- Full UTF-8 text with colour emoji through utf8rastport.library
  (FreeType); without it the text is converted to the system's 8 bit
  character set and drawn with the system fonts
- The text is wrapped again when the window is resized; layout and
  drawing run in their own process, MultiView stays responsive
- MultiView's "Copy" copies the text of the document, "Save As" writes
  the Markdown source
- A default icon for Markdown files (def_markdown.info) and a tool that
  adds the file type to DefIcons, so .md files get this icon on
  Workbench and open in MultiView with a double click
- A demo document with pictures, tables and code (Demo/Demo.md)
- Installer script (English and Turkish) that installs and removes

REQUIREMENTS - please read before installing
   The datatype installs on any AmigaOS 3.x, but it only works as
   described when the following is there. If something is missing it
   may be installed without working correctly: documents may open as
   plain text, without TrueType text and emoji, without pictures, or
   not at all. The installer checks these points and tells you what
   it did not find.

   Needed
   - AmigaOS 3.2 or newer (developed and tested on 3.2.3). It has NOT
     been tested on 3.1, 3.5 and 3.9.
   - 68020 or better. It is 68020 code: do NOT install it on a
     68000/68010, it would crash there.
   - Some free memory: the page is drawn into a bitmap of the window's
     size, and pictures are kept in memory while the document is open.

   Needed for the display shown in the feature list
   - utf8rastport.library (tested with 5.1 and 6.1). It is part of
     EmojiGear by krabobmkd (Aminet: text/edit/EmojiGear5.3.lha or
     newer). Without it there
     are no TrueType fonts, no larger headings and no emoji; characters
     outside your 8 bit character set are replaced by similar ones or
     by "?".
   - TrueType fonts. By default the datatype looks for
       FONTS:_ttf/DejaVuSans.ttf        text
       FONTS:_ttf/DejaVuSansMono.ttf    code
       FONTS:_ttf/NotoColorEmoji32.ttf  emoji
     and, if these are missing, for Vera, Liberation Sans, Verdana,
     Arial or Tahoma in FONTS:_ttf/. Other fonts and the size are set
     in ENVARC:DataTypes/markdown.prefs (see markdown.prefs.example).
     No fonts are included. The DejaVu fonts are free
     (https://dejavu-fonts.github.io); for emoji fonts see the EmojiGear
     documentation.
   - picture.datatype 43 or newer and datatypes for the picture formats
     you use (png.datatype and jpeg.datatype of AmigaOS 3.2 are fine).
     Without them a picture shows its description only.
   - A graphics card (RTG: Picasso96 or CyberGraphX) with a 15, 16, 24
     or 32 bit screen is recommended. On screens with 256 colours or
     less the colours are approximated; pictures on such screens have
     NOT been tested.

   Optional
   - openurl.library, to open web links in your browser. Without it a
     click on a web link copies its address to the clipboard.
   - DefIcons (part of AmigaOS 3.2) running, for the icon of .md files.

Installation
   Double-click Install-markdown_dt. It copies
     Classes/DataTypes/markdown.datatype  to SYS:Classes/DataTypes
     Devs/DataTypes/Markdown, Markdown_UTF-8  to DEVS:DataTypes
     Prefs/Env-Archive/Sys/def_markdown.info  to ENVARC:Sys and ENV:Sys
   and, if you agree, adds the type "markdown" to
   ENVARC:deficons.prefs (the original is kept as
   ENVARC:deficons.prefs.before-markdown). Reboot afterwards. The same
   script removes everything again. To install by hand, copy these
   files yourself and reboot; ReadMe.txt has the details.

   Then open Demo/Demo.md.

Known limits
   Printing is not supported. Footnotes are shown as text, <details>
   blocks are always open, pictures inside a line of text and pictures
   from the web show their description only.

Tested on AmigaOS 3.2.3 with WinUAE (68060, UAEGFX) and on an A1200
with PiStorm/Emu68 (68040, RTG 1920x1080).

Freeware. Copyright (C) 2026 Serkan Dursun. You may use and copy this
package freely as long as it is complete and unchanged; no warranty of
any kind. utf8rastport.library and EmojiGear are by krabobmkd and are
not part of this package.

History
1.0  First release.