I’m using only the API of Discourse with a custom UI. I want to support some custom Markdown extensions which I’d like the “cooked” content of a post to honor. I think there are probably a few ways to do this: Get Discourse to use a custom Markdown parser When posting, convert the Markdown to HTML before submitting it to the Discourse API Getting access to the “raw” post in addition to the “cooked” post after it’s been submitted 1 won’t work for me if it requires a code change to Discourse, because I’d like to use the hosted version. 2 is fine, but we’re still largely limited by what gets “cooked”. For example, we may want to show some dynamic content. Increasingly I think just getting access to the raw content of the original post (3) is probably what I want. Is there a way to do this? Can “cooking” content be disabled via a setting, or the “raw” content obtained via some API call?

What are the exact changes to md you are after?

That’s not totally determined yet, but it’s likely that some content will be rendered dynamically which suggests we won’t want the “cooked” version to be static HTML. I think what we really want is the ability to control what we’re cooking, since we obviously don’t want to throw away whatever sanitation work is done in the process. In our case, we’d probably want to convert “raw” markdown to “cooked” markdown (with whatever scrubbing/moderation happens in that process left intact). I don’t know if this is on the roadmap or what the timeline is, but failing that, it would at least be useful to be able to get access to the “raw” submission content. Is this possible?

Something like this? * open in new tab https://meta.discourse.org/raw/46723

Yes, but doing that for every post is going to get expensive. Ideally I want a way to get this off the topic API (t/:topicId.json) BTW, how do you know about that route? Is there some better API documentation than this topic: Discourse REST API Documentation

[image] cappslock: how do you know about that route? I guess mostly because I’ve spent a lot of time here, I’ve read a lot of posts and I’ve read a good number of lines of code. But also because when I was looking at how post revision history works (note the “raw” button) it could be seen (using the browsers dev tools) that a “raw” route was used. [image] cappslock: Is there some better API documentation than this topic Well, I don’t if it’s better. That’s subjective. But there’s this. https://github.com/discourse/discourse_api

[image] cappslock: Increasingly I think just getting access to the raw content of the original post (3) is probably what I want. This request has come up a couple of times now. @marktheis & co also wants this: [image] Using Discourse as a community-powered wiki Blog The following is a guest post by Sam Nazarko, CEO and founder of OSMC.tv Are you using Discourse in a novel way? If you’re interested in writing a guest post like this one, please get in touch. In 2014, I started working on a new project, OSMC (Open Source Media Center). OSMC is a free and… This topic is for comments on the original blog entry at: Using Discourse as a community-powered wiki

[image] cappslock: Yes, but doing that for every post is going to get expensive. Ideally I want a way to get this off the topic API (t/:topicId.json) This is already implemented these days, by adding ?include_raw=true Eg: https://meta.discourse.org/t/working-with-different-needs-in-raw-cooked-content/46723.json?include_raw=true

Working with different needs in raw/cooked content

Development

erlend_sh (Erlend Sogge Heggen) July 7, 2016, 9:57am 7

This request has come up a couple of times now. @marktheis & co also wants this:

Topic		Replies	Views
Getting Markdown for a post using API Development rest-api	5	731	September 3, 2024
Get back the real "raw" data that created a post? Development	33	4064	January 24, 2026
Retrieving post.raw only works right after creating post Development	6	1089	February 9, 2021
Converting Wiki Posts to HTML Product Support	3	708	February 13, 2022
What markdown parser Discourse is using? Development	6	2193	April 2, 2016

Working with different needs in raw/cooked content

Related topics