Get Advice Icon

Need advice about which tool to choose?Ask the StackShare community!

Asciidoctor
Asciidoctor

10
8
+ 1
0
Markdown
Markdown

5.6K
4.1K
+ 1
966
Add tool

Markdown vs Asciidoctor: What are the differences?

Markdown: Text-to-HTML conversion tool/syntax for web writers, by John Gruber. Markdown is two things: (1) a plain text formatting syntax; and (2) a software tool, written in Perl, that converts the plain text formatting to HTML; Asciidoctor: An open source, pure Ruby processor for converting AsciiDoc documents or strings into HTML and other formats. It is a fast, open source text processor and publishing toolchain for converting AsciiDoc content to HTML5, DocBook, PDF, and other formats. Asciidoctor is written in Ruby and runs on all major operating systems .

Markdown and Asciidoctor are primarily classified as "Languages" and "Text Processors" tools respectively.

- No public GitHub repository available -
- No public GitHub repository available -

What is Asciidoctor?

It is a fast, open source text processor and publishing toolchain for converting AsciiDoc content to HTML5, DocBook, PDF, and other formats. Asciidoctor is written in Ruby and runs on all major operating systems

What is Markdown?

Markdown is two things: (1) a plain text formatting syntax; and (2) a software tool, written in Perl, that converts the plain text formatting to HTML.
Get Advice Icon

Need advice about which tool to choose?Ask the StackShare community!

Why do developers choose Asciidoctor?
Why do developers choose Markdown?
    Be the first to leave a pro

    Sign up to add, upvote and see more prosMake informed product decisions

      Be the first to leave a con
      What companies use Asciidoctor?
      What companies use Markdown?

      Sign up to get full access to all the companiesMake informed product decisions

      What tools integrate with Asciidoctor?
      What tools integrate with Markdown?

      Sign up to get full access to all the tool integrationsMake informed product decisions

      What are some alternatives to Asciidoctor and Markdown?
      Sphinx
      It lets you either batch index and search data stored in an SQL database, NoSQL storage, or just files quickly and easily — or index and search data on the fly, working with it pretty much as with a database server.
      PHP
      Fast, flexible and pragmatic, PHP powers everything from your blog to the most popular websites in the world.
      JavaScript
      JavaScript is most known as the scripting language for Web pages, but used in many non-browser environments as well such as node.js or Apache CouchDB. It is a prototype-based, multi-paradigm scripting language that is dynamic,and supports object-oriented, imperative, and functional programming styles.
      Python
      Python is a general purpose programming language created by Guido Van Rossum. Python is most praised for its elegant syntax and readable code, if you are just beginning your programming career python suits you best.
      Java
      Java is a programming language and computing platform first released by Sun Microsystems in 1995. There are lots of applications and websites that will not work unless you have Java installed, and more are created every day. Java is fast, secure, and reliable. From laptops to datacenters, game consoles to scientific supercomputers, cell phones to the Internet, Java is everywhere!
      See all alternatives
      Decisions about Asciidoctor and Markdown
      Yashu Mittal
      Yashu Mittal
      Founder & CEO at CodeCarrot · | 1 upvotes · 8.8K views
      atCodeCarrotCodeCarrot
      Jekyll
      Jekyll
      Ruby
      Ruby
      Markdown
      Markdown

      Jekyll is an open source static site generator (SSG) with a Ruby at its core which transform your plain text into static websites and blogs.

      It is simple means no more databases, comment moderation, or pesky updates to install—just your content. As said earlier SSG uses Markdown, Liquid, HTML & CSS go in and come out ready for deployment. Lastly it's blog-aware permalinks, categories, pages, posts, and custom layouts are all first-class citizens here.

      See more
      Johnny Bell
      Johnny Bell
      Senior Software Engineer at StackShare · | 13 upvotes · 249.8K views
      atStackShareStackShare
      Markdown
      Markdown
      React
      React
      GraphQL
      GraphQL
      Ruby
      Ruby
      Showdown
      Showdown
      Glamorous
      Glamorous
      Emotion
      Emotion
      styled-components
      styled-components
      #Frontend
      #CssInJs
      #StackDecisionsLaunch

      For Stack Decisions I needed to add Markdown in the decision composer to give our users access to some general styling when writing their decisions. We used React & GraphQL on the #Frontend and Ruby & GraphQL on the backend.

      Instead of using Showdown or another tool, We decided to parse the Markdown on the backend so we had more control over what we wanted to render in Markdown because we didn't want to enable all Markdown options, we also wanted to limit any malicious code or images to be embedded into the decisions and Markdown was a fairly large to import into our component so it was going to add a lot of kilobytes that we didn't need.

      We also needed to style how the markdown looked, we are currently using Glamorous so I used that but we are planning to update this to Emotion at some stage as it has a fairly easy upgrade path rather than switching over to styled-components or one of the other cssInJs alternatives.

      Also we used React-Mentions for tagging tools and topics in the decisions. Typing @ will let you tag a tool, and typing # will allow you to tag a topic.

      The Markdown options that we chose to support are tags: a, code, u, b, em, pre, ul, ol, li.

      If there are anymore tags you'd love to see added in the composer leave me a comment below and we will look into adding them.

      #StackDecisionsLaunch

      See more
      Jerome Dalbert
      Jerome Dalbert
      Senior Backend Engineer at StackShare · | 5 upvotes · 11.7K views
      atStackShareStackShare
      Markdown
      Markdown
      Ruby
      Ruby
      Rails
      Rails
      #StackDecisionsLaunch

      I needed to make stack decisions accept a subset of Markdown, similarly to sites like Reddit or Stack Overflow.

      I used the redcarpet Ruby gem for parsing, and Rails' sanitize helper made it very easy to only allow certain tags: links, bold, italics, lists, code blocks, paragraphs.

      Problem solved! #StackDecisionsLaunch

      See more
      TypeScript
      TypeScript
      JSON
      JSON
      Docker
      Docker
      Markdown
      Markdown
      Angular 2
      Angular 2
      Visual Studio Code
      Visual Studio Code
      Atom
      Atom
      #Typescript
      #Java
      #HTML
      #Sass

      More than year ago I was looking for the best editor of Angular 2 application and I've tried Visual Studio Code and Atom. Atom had performance issues that put me off completely to use it again. Visual Studio Code became my main editor #Typescript files (and partly editor of #Java files). I'm happy with Visual Studio Code and I've never look back on Atom. There wasn't any reason to try Atom again, because Visual Studio Code fulfills my requirements very well. I use it for editing of TypeScript, #HTML, #Sass, JSON, Docker and Markdown.

      See more
      Interest over time
      Reviews of Asciidoctor and Markdown
      No reviews found
      How developers use Asciidoctor and Markdown
      Avatar of StackShare
      StackShare uses MarkdownMarkdown

      We’re using Markdown parsers for Reviews, Blog Posts, and Stack Description (the text you’re reading right now). We’re using Bootstrap Markdown for content input (except for reviews) and RedCarpet for rendering in certain places.

      Avatar of Wing Tang Wong
      Wing Tang Wong uses MarkdownMarkdown

      Markdown represents a highly portable and lightweight text formatting. I had converted all of my Wordpress posts to Markdown prior to migrating over to Jekyll and eventually to Hugo. The fact that many generators support Markdown means that my content remains portable regardless of the platform/engine I use.

      Avatar of Volkan Özçelik
      Volkan Özçelik uses MarkdownMarkdown

      What you see is not what you get, never it is.

      Documentation is better in Markdown format. You don’t need anything special to read it.

      It is compact, portable, comparable.

      Markdown is my text file format of choice.

      Avatar of Jeff Flynn
      Jeff Flynn uses MarkdownMarkdown

      Because it is almost an effortless markup language without ever having to write an HTML tag. Of course, you'll want to use it in environments that make it look pretty (GitHub, etc.)

      Avatar of Roger Salomonsson
      Roger Salomonsson uses MarkdownMarkdown

      Using StackEdit to edit markdown files for blog roll and about sections. MD files are stored in Google Drive and pushed to GH pages through StackEdit.

      How much does Asciidoctor cost?
      How much does Markdown cost?
      Pricing unavailable
      Pricing unavailable
      News about Asciidoctor
      More news