Site Map - skip to main content

Hacker Public Radio

Your ideas, projects, opinions - podcasted.

New episodes Monday through Friday.


hpr3254 :: The Markdown editor Retext

In this episode I cover the markdown editor ReText. I found this useful when creating show notes

<< First, < Previous, Latest >>

Hosted by MrX on 2021-01-21 is flagged as Explicit and is released under a CC-BY-SA license.
Tags: Markdown, HPR, shownotes.
Listen in ogg, spx, or mp3 format. | Comments (0)

What is ReText?

The ReText website on GitHub says that ReText is a simple but powerful editor for Markdown and reStructuredText markup languages.

Doing a search on the HPR site returned the following two references to ReText.

The excellent Markdown and Pandoc HPR 1832 episode by b-yeezi makes reference to ReText

Dave Morriss mentioned using ReText as a possible tool when sending in shownotes as markdown is preferable to plain text. Refer to HPR 3167

Retext Version Info

As of the 1st of January 2021 I am running ReText version 7.0.1 the latest version was 7.1.0 this was last updated on the 4th of April 2020.

Why I am covering this

I’m covering this because in HPR show 3167 Dave Morriss said that Markdown was a preferred way to submit shownotes. Prior to this I had supplied my shownotes in plain text.

What is Markdown?

I guess I first must cover what markdown is I found the following definitions:-

Description of Markdown from Wikipedia

Markdown is a lightweight markup language for creating formatted text using a plain-text editor. John Gruber and Aaron Swartz created Markdown in 2004 as a markup language that is appealing to the human users in its source form.[9] Markdown is widely used in blogging, instant messaging, online forums, collaboration software, documentation pages, and even readme files Link https://en.wikipedia.org/wiki/Markdown

Description of Markdown from John Gruber's website, one of the co founders of Markdown.

Markdown is a text-to-HTML conversion tool for web writers. Markdown allows you to write using an easy-to-read, easy-to-write plain text format, then convert it to structurally valid XHTML (or HTML).

Example text used in the show and how it looks

# This is a level 1 heading

## This is a level 2 heading

### This is a level 3 heading

This is a level 1 heading

This is a level 2 heading

This is a level 3 heading

Finally here are useful links that are available from within the ReText program. They can be found within the Help / About ReText menu:-

Link to ReText website

Link to Markdown syntax

Link to reStructuredText syntax

Final thoughts

  • Using ReText to pull these shownotes together disciplined me to hopefully put more meaningful titles within my shownotes.

  • It helped my to create meaningful descriptive links which will hopefully help accessibility for the visually impaired.

  • I edited the text on this occasion in live preview mode I found this made it very easy to see how the final version would look.

  • I think I ended up with more polished shownotes that hopefully needs fewer and hopefully no input from our band of HPR volunteers working behind the scenes.


Comments

Subscribe to the comments RSS feed.

<< First, < Previous, Latest >>

Leave Comment

Note to Verbose Commenters
If you can't fit everything you want to say in the comment below then you really should record a response show instead.

Note to Spammers
All comments are moderated. All links are checked by humans. We strip out all html. Feel free to record a show about yourself, or your industry, or any other topic we may find interesting. We also check shows for spam :).

Provide feedback
Your Name/Handle:
Title:
Comment:
Anti Spam Question: What does the P in HPR stand for ?
Are you a spammer →
Who hosted this show →
What does HPR mean to you ?